一个超级简单的 PHP 超全局变量管理扩展

一个超级简单的 PHP 超全局变量管理扩展（自卖自夸）

English Document

介绍

SG 全称 Superglobals，它的诞生为了方便快捷操作 PHP 预定义的超全局变量，用户定义的超全局变量。

如果在非 CLI 模式，SG 默认托管 PHP 预定义的超全局变量, 包括常用 $_GET，$_POST，$_COOOKIE，$_SERVER，$_FILES。

使用 SG 类，可以大大的减少我们的 PHP 代码量，提高我们的开发效率。

亮点功能

简单，快速，轻量
零拷贝访问全局变量
支持自动过滤前后空格PHP trim
解决操作 PHP 全局变量时出现未定义系列的问题 (Undefined variable, Undefined offset)

安装

PHP 版本支持包括

PHP 5.4 +
PHP 7.0 +

下载源码

git clone https://github.com/yulonghu/sg.git

Linux 系统，编译 SG 扩展

$ /path/to/php/bin/phpize
$ ./configure --with-php-config=/path/to/php/bin/php-config
$ make && make install

php.ini ，添加、开启扩展

extension=sg.so

[sg]
sg.enable = On

重启 php 进程，就安装成功啦。

提供的方法

mixed sg::get(string $key [, mixed $default_value = null])
bool sg::set(string $key, mixed $value)
bool sg::has(string $key)
bool sg::del(string $key)

支持的 INI 配置项

sg.enable = On/Off
sg.auto_trim = On/Off ; Strip whitespace with PHP trim

详细例子

获取 PHP 预定义的超全局变量

(表格好像不好用呢，这样凑合看吧~)

|传统的获取方式 (短) | 新获取方式|
| ------------- | ------------- |
|$_GET['key']    | sg::get('g.key')|
|$_POST['key']   | sg::get('p.key')|
|$_COOKIE['key'] | sg::get('c.key')|
|$_SERVER['key'] | sg::get('s.key')|
|$_FILES['key']  | sg::get('f.key')|

|传统的获取方式 (长) | 新获取方式|
| ------------- | ------------- |
|$_GET['key']['key1']['key2']    | sg::get('g.key.key1.key2')|
|$_POST['key']['key1']['key2']   | sg::get('p.key.key1.key2')|
|$_COOKIE['key']['key1']['key2'] | sg::get('c.key.key1.key2')|
|$_SERVER['key']['key1']['key2'] | sg::get('s.key.key1.key2')|
|$_FILES['key']['key1']['key2']  | sg::get('f.key.key1.key2')|

|传统的获取方式 (isset + trim) | 新获取方式|
| ------------- | ------------- |
|$key = isset($_GET['key']) ? trim($_GET['key']) : null;       | $key = sg::get('g.key');|
|$key = isset($_POST['key']) ? trim($_POST['key']) : null;     | $key = sg::get('p.key');|
|$key = isset($_COOKIE['key']) ? trim($_COOKIE['key']) : null; | $key = sg::get('c.key');|
|$key = isset($_SERVER['key']) ? trim($_SERVER['key']) : null; | $key = sg::get('s.key');|
|$key = isset($_FILES['key']) ? trim($_FILES['key']) : null;   | $key = sg::get('f.key');|

设置超全局变量

bool sg::set(string $key, mixed $value)

<?php
var_dump(sg::set('test', 'test apple'));
var_dump(sg::set('user.0.0', 'user 0 apple'));
var_dump(sg::set('user.0.1', 'user 1 apple'));
var_dump(sg::set('user.a.a', 'user a apple'));
var_dump(sg::set('user.a.b', 'user b apple'));

// 以下方式不推荐，更新 PHP 预定义的超全局变量值
var_dump(sg::set('g.key', 'value'));
var_dump(sg::set('p.key', 'value'));
var_dump(sg::set('c.key', 'value'));
var_dump(sg::set('s.key', 'value'));
var_dump(sg::set('f.key', 'value'));

以上例子输出的结果:

bool(true)
bool(true)
bool(true)
bool(true)
bool(true)

bool(true)
bool(true)
bool(true)
bool(true)
bool(true)

mixed sg::get(string $key [, mixed $default_value = null])

<?php
var_dump(sg::get('test', 'test apple'));
var_dump(sg::get('user');
var_dump(sg::get('not_found', 'def');
var_dump(sg::get('user.1.2.3.4'));

以上例子输出的结果:

string(10) "test apple"
array(2) {
  [0]=>
  array(2) {
    [0]=>
    string(12) "user 0 apple"
    [1]=>
    string(12) "user 1 apple"
  }
  ["a"]=>
  array(2) {
    ["a"]=>
    string(12) "user a apple"
    ["b"]=>
    string(12) "user b apple"
  }
}
string(3) "def"
NULL

bool sg::has(string $key)

<?php
var_dump(sg::has('test'));
var_dump(sg::has('not_found'));

以上例子输出的结果:

bool(true)
bool(false)

bool sg::del(string $key)

<?php
var_dump(sg::del('test'));
var_dump(sg::del('user.0.1'));
var_dump(sg::get('user');

以上例子输出的结果:

bool(true)
bool(true)
array(2) {
  [0]=>
  array(1) {
    [0]=>
    string(12) "user 0 apple"
  }
  ["a"]=>
  array(2) {
    ["a"]=>
    string(12) "user a apple"
    ["b"]=>
    string(12) "user b apple"
  }
}

sg.auto_trim

演示自动过滤前后空格的例子, 支持两种方式开启自动过滤。

为了获得最佳性能，如果满足 trim 条件, sg 将改变原始值。避免每次取值时重复做 trim 操作。

<?php
ini_set('sg.auto_trim', 1);
function One() {
    var_dump(sg::set('test', ' test apple ')); // Auto-call PHP trim
}
function Two() {
    var_dump(sg::get('test'));
}

以上例子输出的结果:

bool(true)
string(10) "test apple"

License

SG is open source software under the PHP License v3.01