全局扩展

PHP扩展提供了一种在扩展中定义全局变量的方法。 读/写全局变量应该比任何其他全局机制（如静态成员）更快。 您可以使用扩展全局变量来设置更改库行为的配置选项。

在Zephir中，扩展全局变量仅限于简单的标量类型，如 int / bool / double / char 等。 此处不允许使用复杂类型，例如字符串/数组/对象/资源。

您可以通过将以下结构添加到 config.json 来启用扩展全局变量：

  1. {
  2.     "globals": {
  3.         "allow_some_feature": {
  4.             "type": "bool",
  5.             "default": true,
  6.             "module": true
  7.         },
  8.         "number_times": {
  9.             "type": "int",
  10.             "default": 10
  11.         },
  12.         "some_component.my_setting_1": {
  13.             "type": "bool",
  14.             "default": true
  15.         },
  16.         "some_component.my_setting_2": {
  17.             "type": "int",
  18.             "default": 100
  19.         }
  20.     }
  21. }

每个全局具有以下结构：

  1. "<global-name>": {
  2.     "type": "<some-valid-type>",
  3.     "default": <some-compatible-default-value>
  4. }

复合（命名空间）全局变量具有以下结构：

  1. "<namespace>.<global-name>": {
  2.     "type": "<some-valid-type>",
  3.     "default": <some-compatible-default-value>
  4. }

可选的 module 键（如果存在）将全局的初始化过程放入模块范围的 GINIT 生命周期事件中，这意味着它只会在每个PHP进程中设置一次， 而不是为每个请求重新初始化，这是默认值：

  1. {
  2.     "globals": {
  3.         "allow_some_feature": {
  4.             "type": "bool",
  5.             "default": true,
  6.             "module": true
  7.         },
  8.         "number_times": {
  9.             "type": "int",
  10.             "default": 10
  11.         }
  12.     }
  13. }

在上面的例子中，allow_some_feature在启动时只设置一次;number_times是在每个请求开始时设置的。

在任何方法中，您可以使用内置函数globals_get / globals_set读/写扩展全局变量：

  1. globals_set("allow_some_feature", true);
  2. let someFeature = globals_get("allow_some_feature");

如果你想从PHP中改变这些全局变量，一个好的选择是包含一个针对这个的方法:

  1. namespace Test;
  3. class MyOptions
  4. {
  6.     public static function setOptions(array options)
  7.     {
  8.         boolean someOption, anotherOption;
  10.         if fetch someOption, options["some_option"] {
  11.             globals_set("some_option", someOption);
  12.         }
  14.         if fetch anotherOption, options["another_option"] {
  15.             globals_set("another_option", anotherOption);
  16.         }
  17.     }
  18. }

不能动态访问扩展全局, 因为 globals_get/globals_set 优化器生成的 c 代码必须在编译时解析:

  1. let myOption = "someOption";
  3. // will throw a compiler exception
  4. let someOption = globals_get(myOption);