安装

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

基础要求

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

  • Zephir parser >= 1.3.0
  • A C编译器,例如 gcc </ 0» = 4.4或替代方法,例如 clang </ 1» = 3.0, Visual C ++ </ 2» = 11或 Intel C ++。 建议使用 gcc 4.4 或更高版本</li>

    • re2c 0.13.6 或更高版本
    • PHP development headers and tools</ul>

    对于基于 linux 的系统, 您还需要:

    • GNU make 3.81 or later
    • autoconf 2.31 或更高版本
    • automake 1.14 或更高版本
    • libpcre3
    • 在 ubuntu 上 gcc 时使用build-essential 包 (也可能在其他发行版中使用)

    如果您使用的是 ubuntu, 则可以通过以下方式安装所需的包:

      sudo apt-get update
      sudo apt-get install git gcc make re2c php php-json php-dev libpcre3-dev build-essential
    

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

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

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

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

      phpize -v
      Configuring for:
      PHP Api Version:         20180731
      Zend Module Api No:      20180731
      Zend Extension Api No:   320180731
    

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

## 安装 Zephir

首先, 确保安装并激活了 Zephir 解析器扩展。 You can find installation instructions in the [Zephir Parser repository](https://github.com/phalcon/php-zephir-parser).

### Release PHAR

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`.)

### Composer

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:

#### Global Composer Application

```bash
composer global require phalcon/zephir
```

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.

#### Project Dependency

```bash
composer require phalcon/zephir
```

Use `composer exec zephir` within the project you installed Zephir in, above, to run it. (Alternately, you can still run `vendor/bin/zephir`.)

### Git Clone

Finally, you can also simply clone the latest tag from GitHub, install the dependencies, and run Zephir from there:

```bash
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
composer install
```

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.

## 测试安装

检查Zephir是否可以从任何目录执行:

```bash
zephir 帮助
```