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