Zephir入门 - Hello world篇
Zephir 是一个开源的用于简化PHP扩展的创建和维护的语言。它使得不擅长C/C++的PHP开发人员也能写出PHP扩展。Zephir是Zend Engine/PHP/Intermediate缩写,读音为zephyr。
Zephir在语法上跟PHP有很多相似之处,PHP开发人员可以很快上手,但也有很多地方上的不同需要我们去学习。下面是Zephir一些主要的特色:
- 变量类型:动态/静态
- 内存安全:不允许指针和直接的内存管理
- 编译模型:AOT(ahead of time)
- 内存模型:task-local垃圾回收
安装
依赖
要使用Zephir和编译出一个PHP扩展,需要先安装以下的依赖:
- gcc >= 4.x/clang >= 3.x
- re2c 0.13+
- gnu make 3.81+
- autoconf 2.31+
- automake 1.14+
- libpcre3
- php development headers and tools
安装
这里选择使用git的方式获取源代码并进行安装:
bash$ git clone https://github.com/phalcon/zephir $ cd zephir $ ./install-json $ ./install -c
如果已经安装了json-c,那么可以忽略./install-json这一步。
验证
通过运行zephir命令验证下是否安装成功:
bash$ zephir help _____ __ _ /__ / ___ ____ / /_ (_)____ / / / _ \/ __ \/ __ \/ / ___/ / /__/ __/ /_/ / / / / / / /____/\___/ .___/_/ /_/_/_/ /_/ Zephir version 0.7.1b Usage: command [options] Available commands: stubs Generates extension PHP stubs install Installs the extension (requires root password) fullclean Cleans the generated object files in compilation build Generate/Compile/Install a Zephir extension generate Generates C code from the Zephir code clean Cleans the generated object files in compilation builddev Generate/Compile/Install a Zephir extension in development mode compile Compile a Zephir extension version Shows the Zephir version api [--theme-path=/path][--output-directory=/path][--theme-options={json}|/path]Generates a HTML API help Displays this help init [namespace] Initializes a Zephir extension Options: -f([a-z0-9\-]+) Enables compiler optimizations -fno-([a-z0-9\-]+) Disables compiler optimizations -w([a-z0-9\-]+) Turns a warning on -W([a-z0-9\-]+) Turns a warning off
我们的第一个扩展
下面我们使用Zephier来创建一个“hello world”扩展。
初始化
首先,我们使用init命令来初始化扩展的基本结构(假设我们扩展的名称为“utils”):
bash$ zephir init utils
成功运行后,我们应该会得到如下的目录结构:
bashutils/ ext/ utils/
ext目录里放的是编译器需要用到的代码,不用理会,我们的Zephir代码将放在跟扩展名同名的utils里。
编写代码
我们在utils目录下创建一个文件:greeting.zep,并编写代码:
phpnamespace Utils; class Greeting { public static function say() { echo "hello world!"; } }
这里不深入Zephir的语法,但是可以看到语法跟PHP很类似,上面的代码定义了一个类Greeting和一个方法say()。
Zephir的语法详情可以参考官方的文档: http://zephir-lang.com/language.html 。
编译
接下来,我们回到utils根目录下并运行build命令编译出扩展:
bash$ zephir build Preparing for PHP compilation... Preparing configuration file... Compiling... Installing... Extension installed! Add extension=utils.so to your php.ini Don't forget to restart your web serverp
编译成功后,我们在PHP配置文件里增加以下一行:
iniextension=utils.so
验证
通过如下命令查看我们的扩展是否正常加载:
bashphp -m [PHP Modules] ... memcached mysql mysqli mysqlnd openssl utils ...
如果看到我们扩展的名字,则证明已成功加载。
然后我们在PHP里调用say()方法:
php<?php echo Utils\Greeting::say(), "\n";
正常的话会输出:hello world!。至此我们也完成了我们的第一个扩展。