zephir mysql_[Zephir官方文档翻译之五] 入门指导

入门指导

Zephir还有这本手册，是为了PHP开发者想开发C扩展并降低复杂度面打算的。

我们假设你有编程语言的基础。我们会在介绍的时候尽可能的向PHP，C，Javascript等语言的特点来陈述。 如果你懂得这些语言中的某一种的话，我们会指出它们来Zephir的相似点。当然其它的一些Zephir的新特性还有 不同点我们也会一一介绍。

检测安装情况

如果你成功的安装了Zephir，你可以在命令行中执行下面的命令:

$ zephir help

如果安装正确的话，你会看到下面的提示:

_____              __    _

/__  /  ___  ____  / /_  (_)____

/ /  / _ \/ __ \/ __ \/ / ___/

/ /__/  __/ /_/ / / / / / /

/____/\___/ .___/_/ /_/_/_/

/_/

Zephir version 0.4.5a

Usage:    command [options]Available commands:

build               Generate/Compile/Install a Zephir extension

clean               Cleans the generated object files in compilation

compile             Compile a Zephir extension

full-clean          Cleans the generated object files in compilation

generate            Generates C code from the Zephir code    help                Displays this help    init [namespace]    Initializes a Zephir extension

install             Installs the extension (requires root password)

version             Shows Zephir version

目录结构

首先我们要做的是建立一个基础的项目结构，它为我们开发扩展提供了基本的结构。这里，我们建立了一个扩展叫做"utils":

$ zephir init utils

执行上面的命令后，一个名为"utils"的目录被建立在当前的目录下：

utils/

ext/

utils/

目录 "ext/" (inside utils) 包含了编译器将会用到来编译扩展的代码. 另一个目录是"utils"，这个目录的名字必须要和我们的扩展名字保持一至。我们写的Zephir代码将会被放到这里。

We need to change the working directory to "utils" to start compiling our code:

$ cd utils$ ls

ext/ utils/ config.json

列出的目录中，还有一个文件叫做"config.json"，这个文件包括了一些配置，它可以用来改变Zephir和扩展的行为。

增加我们的第一个类

Zephir是被设计成开发面向对象扩展的。为了开发出我们的第一个功能，我们增加一个类到扩展中。

就像很多工具和语言一样，第一件事就是去写"hello world"。同时也检测Zephir是不是可以正常运作。 所以我们的第一个类就叫作"Utils\Greeting"，它包含了一个函数，这个函数会打印出"hello world!"。

The code for this class must be placed in "utils/utils/greeting.zep":

namespace Utils;class Greeting{

public static function say()

{

echo "hello world!";

}}

下面开始编译并生成扩展：

$ zephir build

首先，只会在第一次执行的时候，大量的内部命令被执行，并产生了一些必要的代码和配置文件，最终把这个类生成PHP的扩展。 如果一切顺利的话，你将会看到：

...Extension installed!Add extension=utils.so to your php.iniDon't forget to restart your web server

在上面的步骤中，你可能需要提供你的root帐号和密码去安装这个扩展。 最后，这个扩展必须增加到php.ini文件中，以便PHP可以加载它： extension=utils.so

初始化测试

现在这个扩展已经增加到php.ini文件中了，执行下面的命令来确认扩展是否已经正确的加载进来了：

$ php -m[PHP Modules]Core

date

libxml

pcre

Reflection

session

SPL

standard

tokenizer

utils

xdebug

xml

扩展utils必须要出现在上面的列表中。那么现在，我们尝试在PHP中运行这个hello world扩展。 为了完成这个测试，我们写了一个简单的PHP代码来执行扩展中的静态函数：

恭喜！，你已经完成你的第一个PHP扩展了。

一些有用的类

"hello world"这个类的扩展是用来检测我们的不幸是否正确的。现在，让我们建立一些其它更有用处的类。

第一个有用的类我们将要增加到PHP扩展中将会提供一个过滤工具给用户。 这个类就叫做"Utils\Filter"，这个类的代码必须要放在"utils/utils/filter.zep"中:

这个类的基本的框架如下:

namespace Utils;class Filter{}

这个类包含了一个函数，这个函数的作用是帮助用户去过滤一些不合法的字符。 第一个函数叫做"alpha"，它的目标就是去过滤非ascii码的字符。 开始，我们只是简单的打印出字符串的每一个字节：

namespace Utils;class Filter{

public function alpha(string str)

{

char ch;

for ch in str {

echo ch, "\n";

}

}}

当调用这个函数的时候:

<?php $f = new Utils\Filter();$f->alpha("hello");

You will see:

h

e

l

l

o

检查字符串中的每一个字符是一个直接了当的方法，现在我们建立另一个正确过滤字符的函数：

class Filter{

public function alpha(string str) -> string

{

char ch; string filtered = "";

for ch in str {

if (ch >= 'a' && ch <= 'z') || (ch >= 'A' && ch <= 'Z') {

let filtered .= ch;

}

}

return filtered;

}}

这个写好的函数可以像刚才一样测试:

<?php $f = new Utils\Filter();echo $f->alpha("!he#02l3'121lo."); // prints "hello"

下面的视频演示了上面的这些过程:

结论

这是一个简单的指导教程，但是正如你所见到的，使用Zephir你可以很容易的建立一个PHP扩展。 我们建议你继续阅读这个手册，以便你可以了解更多Zephir的特性。