phpy：PHP與Python互調用庫

phpy 是識沃團隊最新推出的開源項目，目標是為PHP引入Python生態，來彌補PHP生態的空缺和不足。phpy使得PHP可以調用所有Python的包。 包括當下非常流行的PyTorch、transformers、TensorFlow等AI庫，以及Numpy、Pandas、Scikit等科學計算庫，還可以使用PyQt、wxPython等圖形界面庫。

不建議在php-fpm/apache短生命周期運行環境下使用，頻繁地導入 / 銷毀模塊的開銷會消耗大量資源

編譯安裝

phpy可以作為PHP的擴展，也可以作為Python的C模塊。既可以在PHP代碼中調用Python的庫，也可以在Python中調用PHP的類和函數。

作為Python模塊時依賴PHP的embed SAPI，檢查PHP的目錄中，確保存在libphp.so

ll /opt/php-8.1/lib/libphp.so
-rwxr-xr-x 1 htf htf 39397224 11月 30 19:25 /opt/php-8.1/lib/libphp.so*

編譯依賴

Python 3.10或以上版本，建議使用conda工具來安裝

PHP 8.1或以上版本

Python將安裝到/opt/anaconda3目錄下

/opt/anaconda3/bin/pythonPython主程序

/opt/anaconda3/include/python3.11頭文件

/opt/anaconda3/lib/python3.11動態鏈接庫目錄

另外需要配置/etc/ld.so.conf.d/conda.conf加入/opt/anaconda3/lib和/opt/php-8.1/lib。執行ldconfig檢查是否可以找到libpython3.11.so和libphp.so。

sudo ldconfig -p |grep php
    libphp7.so (libc6,x86-64) => /opt/php-7.4/lib/libphp7.so
    libphp.so (libc6,x86-64) => /opt/php-8.0/lib/libphp.so
    
sudo ldconfig -p |grep python
    libsamba-policy.cpython-38-x86-64-linux-gnu.so.0 (libc6,x86-64) => /usr/lib/x86_64-linux-gnu/libsamba-policy.cpython-38-x86-64-linux-gnu.so.0
    libpython3.11.so.1.0 (libc6,x86-64) => /opt/anaconda3/lib/libpython3.11.so.1.0
    libpython3.11.so (libc6,x86-64) => /opt/anaconda3/lib/libpython3.11.so
    libpython3.8.so.1.0 (libc6,x86-64) => /usr/lib/x86_64-linux-gnu/libpython3.8.so.1.0
    libpython3.8.so (libc6,x86-64) => /usr/lib/x86_64-linux-gnu/libpython3.8.so
    libpython3.5m.so.1.0 (libc6,x86-64) => /usr/lib/x86_64-linux-gnu/libpython3.5m.so.1.0
    libpython3.so (libc6,x86-64) => /opt/anaconda3/lib/libpython3.so
    libpython2.7.so.1.0 (libc6,x86-64) => /usr/lib/x86_64-linux-gnu/libpython2.7.so.1.0
    libpython2.7.so (libc6,x86-64) => /usr/lib/x86_64-linux-gnu/libpython2.7.so

作為PHP擴展

檢查config.m4中Python路徑是否正確。若Python的安裝路徑不是/opt/anaconda3，需修改為正確的安裝路徑。

cd phpy
phpize
./configure
make install

安裝成功后，修改php.ini，加入extension=phpy.so，執行php -m和php --ri phpy檢查是否成功加載擴展。

作為Python模塊

cmake .
make -j

import phpy

使用方法

導入 Python 模塊

$os = PyCore::import('os');

執行函數

$uname = $os->uname();

讀取屬性

echo $uname->sysname;

加載路徑

可使用PyCore::import('sys')->path->append()將一些目錄加入到加載路徑列表中。
例如：/workspace/app/user.py自定義的包，可以通過下面的步驟實現加載：

PyCore::import('sys')->path->append('/workspace')將/workspace添加到sys.path中

PyCore::import('app.user')將自動搜索sys.path找到對應的app/user.py包并載入

內置方法

PyCore::str()將對象轉為字符串

PyCore::repr()

PyCore::type()獲取對象的類型

PyCore::locals()獲取當前空間內容的所有局部變量

PyCore::globals()獲取所有全局變量

PyCore::hash()獲取 Hash 值

PyCore::hasattr()檢測對象是否存在某個屬性

PyCore::id()獲取對象的內部編號

PyCore::len()獲取長度

PyCore::dir()獲取對象所有的屬性、方法

PyCore::int()構造一個整數

PyCore::float()構造一個浮點數

PyCore::fn()構造一個可調用函數

PyCore::scalar()將PyObject對象轉為PHP的標量類型，例如PyStr將轉為PHP 字符串，Dict/Tuple/Set/List將轉為Array

內置類

PyObject：所有其他類型的基類

PyDict：字典類型，等同于PHP的關聯數組

PyList：列表類型，等同于PHP的索引數組

PyTuple：元組，不可變的列表

PyStr：字符串

PyModule：Python包，PyModule也是PyObject的子類

PyObject是除了PyCore之外，所有其他類型的基類。非內置類的對象是PyObject的實例。PyObject實現了4個魔術方法，用于將操作映射到Python對象。 所有類方法、參數、返回值參考stubs目錄中的文件。

繼承關系

PyObject -> PyModule
         -> PySequenece -> PyList
                        -> PyTuple
         -> PySet
         -> PyStr
         -> PyDict
         -> PyType

整數

Python語言是天然支持無限精度整型計算的，可以使用Python的整數計算能力來代替ext-bcmath

構造

使用PyCore::int()函數來構造一個數字，可以傳入整數、浮點數、字符串來初始化。

$i1 = PyCore::int(12345678);
$i2 = PyCore::int('1234567890123456789012345678901234567890');
$i3 = PyCore::int(12345678.03);

運算

整數同樣也是PyObject的實例，可以使用內置的方法類實現運算。

$i = PyCore::int(12345435);
var_dump(strval($i->__pow__(3)));
var_dump(strval($i->__add__(4)));

命名參數

phpy支持了命名參數，可以使用命名參數來調用Python的函數和方法。 順序參數必須在前，命名參數必須在最后

kwargs($a, $b, $c, name: 'hello', world: 'rango');

kwargs(a, b, c, name: 'hello', world: 'rango')

回調函數

可將PHP的可調用對象作為Python的回調函數。使用PyCore::fn(callable $fn)包裹即可。

$m = PyCore::import('app.user');
$uuid = uniqid();
$rs = $m->test_callback(PyCore::fn(function ($namespace) use ($uuid) {
    var_dump($namespace);
    return $uuid;
}));

import app.user導入了一個自定義Python包

調用了包中的一個函數test_callback，此函數接受一個參數為Python Callable對象

使用PyCore::fn()包裹了一個Closure閉包對象作為回調，這里也支持函數名稱字符串、對象方法的調用方式

回調函數返回了一個字符串，在test_callback函數中會得到一個str類型返回值

可參考下方的Python tkinter例子。

實際案例

基于tkinter實現GUI的例子

Tk();
$root->title('我的窗口');
$root->geometry("500x500");
$root->resizable(False, False);

$button= $tkinter->Button($root, text: "Click Me!!", command: PyCore::fn(function () {
    var_dump(func_get_args());
    echo 'click me!!'. PHP_EOL;
}));
$button->pack();

$tkinter->mainloop();

一個基于transformers的情感分析模型推理實現

environ->__setitem__('https_proxy', getenv('https_proxy'));

$distilled_student_sentiment_classifier= $transformers->pipeline(
    model: "lxyuan/distilbert-base-multilingual-cased-sentiments-student",
    top_k: null,
);

$rs= $distilled_student_sentiment_classifier("I love this movie and i would watch it again and again!");
var_dump(PyCore::scalar($rs));