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!。至此我们也完成了我们的第一个扩展。

参考

http://zephir-lang.com/index.html