[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代码来执行扩展中的静态函数：
<?phpecho Utils\Greeting::say(), "\n";
恭喜！，你已经完成你的第一个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的特性。