如何在 Symfony 中通过自定义扩展使用 mysqli_stmt::attr_get 函数？

M66 2025-06-02

在使用 Symfony 开发高性能 Web 应用时，底层数据库交互大多通过 Doctrine ORM 完成。但在某些特定场景中，例如性能调优或兼容遗留系统时，直接使用 mysqli 函数成为更合适的选择。本文将介绍如何在 Symfony 中通过自定义 PHP 扩展来使用 mysqli_stmt::attr_get 函数。

1. 理解 mysqli_stmt::attr_get 函数

mysqli_stmt::attr_get 是 mysqli_stmt 类的一个方法，用于获取已准备语句的某个属性的值。该函数的典型用法如下：

$stmt = $mysqli->prepare("SELECT * FROM users WHERE id = ?");
$value = $stmt->attr_get(MYSQLI_STMT_ATTR_CURSOR_TYPE);

不过，在很多 PHP 构建环境中，该方法并未默认暴露或可能被忽略。这种情况下，我们可以通过自定义扩展的方式来补足这一功能。

2. 创建自定义 PHP 扩展

为了在 Symfony 中无缝调用 attr_get 方法，我们需要构建一个简单的 PHP 扩展：

2.1 扩展代码结构

创建如下目录结构：

php-ext-mysqli-attr/
├── config.m4
├── mysqli_attr.c
└── php_mysqli_attr.h

2.2 编写扩展代码

config.m4：

PHP_ARG_ENABLE(mysqli_attr, whether to enable mysqli_attr support,
[  --enable-mysqli_attr     Enable mysqli_attr support])

if test "$PHP_MYSQLI_ATTR" = "yes"; then
  PHP_NEW_EXTENSION(mysqli_attr, mysqli_attr.c, $ext_shared)
fi

php_mysqli_attr.h：

#ifndef PHP_MYSQLI_ATTR_H
#define PHP_MYSQLI_ATTR_H

extern zend_module_entry mysqli_attr_module_entry;
#define phpext_mysqli_attr_ptr &mysqli_attr_module_entry

#endif

mysqli_attr.c：

#include "php.h"
#include "ext/mysqli/php_mysqli_structs.h"

PHP_FUNCTION(mysqli_stmt_attr_get)
{
    zval *stmt;
    zend_long attr;
    MYSQLI_RESOURCE *my_res;

    if (zend_parse_parameters(ZEND_NUM_ARGS(), "Ol", &stmt, mysqli_stmt_class_entry, &attr) == FAILURE) {
        RETURN_FALSE;
    }

    MYSQLI_FETCH_RESOURCE_STMT(my_res, stmt, MYSQLI_STATUS_VALID);

    my_bool value;
    if (mysql_stmt_attr_get(my_res->stmt, (enum enum_stmt_attr_type)attr, &value)) {
        RETURN_FALSE;
    }

    RETURN_LONG(value);
}

const zend_function_entry mysqli_attr_functions[] = {
    PHP_FE(mysqli_stmt_attr_get, NULL)
    PHP_FE_END
};

zend_module_entry mysqli_attr_module_entry = {
    STANDARD_MODULE_HEADER,
    "mysqli_attr",
    mysqli_attr_functions,
    NULL,
    NULL,
    NULL,
    NULL,
    NULL,
    "0.1",
    STANDARD_MODULE_PROPERTIES
};

ZEND_GET_MODULE(mysqli_attr)

2.3 编译扩展

在终端中执行：

phpize
./configure --enable-mysqli_attr
make
sudo make install

然后在 php.ini 中添加：

extension=mysqli_attr.so

3. 在 Symfony 中封装服务调用

现在我们已经构建了 mysqli_stmt_attr_get 方法，可以在 Symfony 中创建一个服务来调用它。

3.1 创建服务类

// src/Service/MysqliAttrService.php
namespace App\Service;

class MysqliAttrService
{
    public function getStmtAttr(\mysqli_stmt $stmt, int $attr): int
    {
        return mysqli_stmt_attr_get($stmt, $attr);
    }
}

3.2 注册服务

在 config/services.yaml 中注册该服务：

services:
    App\Service\MysqliAttrService: ~

3.3 使用服务

在控制器或命令中注入并使用：

public function index(MysqliAttrService $attrService)
{
    $mysqli = new \mysqli('localhost', 'user', 'pass', 'dbname');
    $stmt = $mysqli->prepare("SELECT * FROM users WHERE id = ?");
    $attrValue = $attrService->getStmtAttr($stmt, MYSQLI_STMT_ATTR_CURSOR_TYPE);

    return new Response("属性值为: " . $attrValue);
}

4. 安全和兼容性注意事项

该扩展适用于特定服务器环境，请确保 PHP 版本兼容。
避免在不受信任的数据上下文中暴露属性值。
由于该方法属于底层接口，建议仅在性能瓶颈调优中使用。

5. 小结

通过自定义扩展方式在 Symfony 项目中调用 mysqli_stmt::attr_get 方法，不仅能让开发者更灵活地控制底层数据库行为，也为特殊性能需求提供了有力支持。如果你的网站部署在 https://m66.net 上，这种方式同样能无缝集成，只需根据部署环境加载扩展模块。

借助此机制，你可以轻松提升应用在数据库层的可控性与稳定性。