码迷,mamicode.com
首页 > 其他好文 > 详细

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

时间:2014-09-26 21:43:18      阅读:195      评论:0      收藏:0      [点我收藏+]

标签:style   http   color   io   os   使用   ar   java   for   

入门指导

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的特性。


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

标签:style   http   color   io   os   使用   ar   java   for   

原文地址:http://my.oschina.net/u/1777357/blog/318930

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!