• 安装
    • 基础要求

    安装

    要安装 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
    3. 首先, 确保安装并激活了 Zephir 解析器扩展。 You can find installation instructions in the [Zephir Parser repository](https://github.com/phalcon/php-zephir-parser).
    5. ### Release PHAR
    7. 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`.)
    9. ### Composer
    11. 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:
    13. #### Global Composer Application
    15. ```bash
    16. composer global require phalcon/zephir
    17. ```
    19. 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.
    21. #### Project Dependency
    23. ```bash
    24. composer require phalcon/zephir
    25. ```
    27. Use `composer exec zephir` within the project you installed Zephir in, above, to run it. (Alternately, you can still run `vendor/bin/zephir`.)
    29. ### Git Clone
    31. Finally, you can also simply clone the latest tag from GitHub, install the dependencies, and run Zephir from there:
    33. ```bash
    34. 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
    35. composer install
    36. ```
    38. 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. ## 测试安装
    3. 检查Zephir是否可以从任何目录执行:
    5. ```bash
    6. zephir 帮助
    7. ```