安装

要安装 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. ```