• 安装
    • 基础要求

    安装

    要安装 Zephir, 请按照下列步骤操作:

    基础要求

    要构建PHP扩展并使用Zephir,您需要满足以下要求:

    • Zephir parser >= 1.3.0
    • A C编译器,例如 gcc

      • re2c 0.13.6 或更高版本
      • PHP development headers and tools 对于基于 linux 的系统, 您还需要:

      • GNU make 3.81 or later

      • autoconf 2.31 或更高版本
      • automake 1.14 或更高版本
      • libpcre3
      • 在 ubuntu 上 gcc 时使用build-essential 包 (也可能在其他发行版中使用) 如果您使用的是 ubuntu, 则可以通过以下方式安装所需的包:
    1. sudo apt-get update
    2. sudo apt-get install git gcc make re2c php php-json php-dev libpcre3-dev build-essential

    请注意,阅读本指南时特定版本的库和程序可能有所不同。

    由于Zephir代码的编写是在PHP中进行的,所以需要安装最新版本的PHP,并且必须在您的控制台中可用:

    1. php -v
    2. PHP 7.3.7 (cli) (built: Jul 14 2019 17:24:22) ( ZTS DEBUG )
    3. Copyright (c) 1997-2018 The PHP Group
    4. Zend Engine v3.3.7, Copyright (c) 1998-2018 Zend Technologies
    5. with Zend OPcache v7.3.7, Copyright (c) 1999-2018, by Zend Technologies
    6. with Xdebug v2.7.2, Copyright (c) 2002-2019, by Derick Rethans

    此外, 请确保您在安装 php 的同时安装了 php 开发库:

    1. phpize -v
    2. Configuring for:
    3. PHP Api Version: 20180731
    4. Zend Module Api No: 20180731
    5. Zend Extension Api No: 320180731

    您不必确切看到的以上输出,但是这些命令对于开始使用Zephir进行开发非常重要。

    1. ## 安装 Zephir
    2. 首先, 确保安装并激活了 Zephir 解析器扩展。 You can find installation instructions in the [Zephir Parser repository](https://github.com/phalcon/php-zephir-parser).
    3. ### Release PHAR
    4. The recommended, **officially supported**, and easiest-to-use way to install Zephir is to simply grab the latest release PHAR [from GitHub](https://github.com/phalcon/zephir/releases/latest), and download/move it to somewhere in your `$PATH`. (You'll probably also want to rename it to drop the `.phar` extension, so you can run it as `zephir` instead of `zephir.phar`.)
    5. ### Composer
    6. The PHAR isn't available before 0.11.4, so if you need an older version, you can use Composer, in one of two ways:
    7. #### Global Composer Application
    8. ```bash
    9. composer global require phalcon/zephir
    10. ```
    11. There are two approaches to running Zephir at this point. The first is to ensure that `${COMPOSER_HOME}/vendor/bin` is in your `$PATH`, then Zephir should be available as `zephir` on the command line. The second is to simply use `composer global exec zephir` instead.
    12. #### Project Dependency
    13. ```bash
    14. composer require phalcon/zephir
    15. ```
    16. Use `composer exec zephir` within the project you installed Zephir in, above, to run it. (Alternately, you can still run `vendor/bin/zephir`.)
    17. ### Git Clone
    18. Finally, you can also simply clone the latest tag from GitHub, install the dependencies, and run Zephir from there:
    19. ```bash
    20. git clone --depth 1 -b $(git ls-remote https://github.com/phalcon/zephir 0.12.* | sort -t/ -k3 -Vr | head -n1 | awk -F/ '{ print $NF }') https://github.com/phalcon/zephir
    21. composer install
    22. ```
    23. You'll need to either use the path to `zephir/zephir`, or create a symlink in a directory in your `$PATH`, to run Zephir using this option.

    1. ## 测试安装
    2. 检查Zephir是否可以从任何目录执行:
    3. ```bash
    4. zephir 帮助
    5. ```