一個超級簡單的PHP超全域性變數管理擴充套件

fanjiapeng發表於2019-03-30
PHP變數套件
GitHub: github.com/yulonghu/sg


介紹

SG 全稱 Superglobals，它的誕生為了方便快捷操作PHP預定義的超全域性變數，使用者定義的超全域性變數。

如果在非CLI模式，SG預設託管PHP預定義的超全域性變數, 包括$_GET, $_POST, $_COOOKIE, $_SERVER, $_FILES。

使用SG類，能讓複雜的程式碼變得簡單，開啟自動過濾還能減少程式碼量，進而提高我們的開發效率。

亮點功能

  • 簡單，快速，輕量
  • 零拷貝訪問全域性變數
  • 支援自動過濾前後空格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-fpm，就安裝成功啦。

提供的方法

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預定義的超全域性變數

OLD GET METHOD (Short)NEW GET METHOD
$_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')
OLD GET METHOD (Long)NEW GET METHOD
$_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')
OLD GET METHOD (isset + trim)NEW GET METHOD
$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');
(PHP7) 傳統的獲取方式 (??)新獲取方式
$key = $_GET['key'] ?? null; $key = trim($key);$key = sg::get('g.key');
$key = $_POST['key'] ?? null; $key = trim($key);$key = sg::get('p.key');
$key = $_COOKIE['key'] ?? null; $key = trim($key);$key = sg::get('c.key');
$key = $_SERVER['key'] ?? null; $key = trim($key);$key = sg::get('s.key');
$key = $_FILES['key'] ?? null; $key = trim($key);$key = sg::get('f.key');

通過以上的整理，可以得出一個結論，傳統取值方式容易出錯，如果陣列維度越深，程式碼複雜度會直線上升。

使用SG，這些情況都變得很簡單。更新、刪除方式類同。

設定超全域性變數

sg::set

<?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'));複製程式碼

以上例子輸出的結果:

bool(true)
bool(true)
bool(true)
bool(true)
bool(true)
複製程式碼

sg::get

<?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
複製程式碼

sg::has

<?php
var_dump(sg::has('test'));
var_dump(sg::has('not_found'));複製程式碼

以上例子輸出的結果:

bool(true)
bool(false)
複製程式碼

sg::del

<?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

演示自動過濾前後空格的例子, 兩種方式開啟自動過濾。

<?php
// sg.auto_trim = On ; php.ini
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



相關文章