Системные требования

Чтобы собрать расширение под PHP и использовать Zephir нужно:

  • Zephir parser >= 1.1.0
  • Один из следующих C компиляторов: gcc >= 4.4, clang >= 3.0, Visual C++ >= 11 или Intel C++. Рекомендуется gcc 4.4 или старше
  • re2c 0.13.6 или старше
  • Заголовочные файлы PHP и инструменты разработчика

Для систем на базе Linux, вам понадобится также:

  • GNU make 3.81 или старше
  • autoconf 2.31 или старше
  • automake 1.14 или старше
  • libpcre3
  • Пакет build-essential, если вы используете gcc в Ubuntu (и, вероятно, в других дистрибутивах)

На 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 должен быть доступен из консоли:

$ php -v
PHP 7.0.8 (cli) (built: Jun 26 2016 00:59:31) ( NTS )
Copyright (c) 1997-2016 The PHP Group
Zend Engine v3.0.0, Copyright (c) 1998-2016 Zend Technologies
        with Zend OPcache v7.0.8, Copyright (c) 1999-2016, by Zend Technologies

Также проверьте, доступны ли dev-инструменты для сборки расширений:

$ phpize -v
Configuring for:
PHP Api Version:         20151012
Zend Module Api No:      20151012
Zend Extension Api No:   320151012

Вам не обязательно нужно получить точно такой же вывод. Однако важно, чтобы эти команды были доступны для начала разработки на Zephir.

Установка Zephir

С использованием Git

Для начала убедитесь что Zephir parser установлен и активирован. За подробностями обратитесь к следующему руководству.

Склонируйте репозиторий Zephir:

$ git clone https://github.com/phalcon/zephir

Чтобы скомпилировать и установить Zephir выполните следующие команды:

$ cd zephir
$ ./install -c

Последнее, что вам необходимо сделать, это убедиться, что у вас включены все необходимые расширения и установлены все зависимости:

composer install

Этот шаг не является обязательным для версии 0.10.x, однако он станет обязательным для последующих версий.

Протестируйте Zephir

Проверьте, доступен ли Zephir из любой директории командой:

$ zephir help

Руководство по установке / использованию Zephir (Windows)

В этом руководстве объясняется, как использовать zephir с помощью операционной системы Windows. Некоторые части являются необязательными, если у вас определенная версия PHP. Части, которые необходимы только для конкретной версии PHP, помечены как таковые. Требования к PHP-версии отмечены с использованием [ ]

Требования к ПО [PHP 7.0 или позже]

Требования к программному обеспечению

  • Установка PHP (NTS)
    • Загрузите и извлеките его
    • Убедитесь, что он находится в PATH, как показано ниже:
    setx path "%path%;c:\path-to-php\"

    Переменную PATH лучше модифицировать через графический интерфейс в свойствах компютера, во избежания порчи системы.

  • Установите PHP SDK для PHP 5.6(в настоящее время php-sdk-binary-tools-20110915.zip является новейшим)
  • Установите PHP SDK для PHP 7.0+
    setx php_sdk "c:\path-to-php-sdk"
  • Скачать PHP Developer Pack(NTS!) (или построить его самостоятельно с опцией --enable-debug --disable-zts и nmake build-devel или просто nmake snap с помощью PHP-SDK)
    setx php_devpack "c:\path-to-extracted-devpack"

Установка Zephir

  • Клонировать / скачать репозиторий
    Вы можете использовать composer
    composer require phalcon/zephir:dev-master
    Затем переместить проект выполните следующую команду
    vendor/bin/zephir generate
  • И установить путь, как показано ниже
    (Переменную PATH лучше модифицировать через графический интерфейс в свойствах компютера, во избежания порчи системы.)
    setx path "%path%;c:\path-to-zephir\bin"

Установка парсера Zephir

  1. Скачать Zephir Parser для Windows
  2. Извлеките файл DLL и скопируйте его в каталог расширений PHP
  3. Отредактируйте php.ini и добавьте эту строку:
    [Zephir Parser]
    ; You can use here absolute path to your custom modules dir
    ; or relative to the PHP modules dir
    extension=zephir_parser.dll

Примечание: также вы можете скомпилировать его самостоятельно.

Использование Zephir

  • [PHP7 или позже] Открыть командную строку Visual Studio 2015 (искать по cmd или просто открыть "%VS140COMNTOOLS%\VsDevCmd")
  • [PHP5.5 или позже] Открыть командную строку Visual Studio 2012 (искать по cmd или просто открыть "%VS110COMNTOOLS%\VsDevCmd")
  • Выполнить %PHP_SDK%\bin\phpsdk_setvars
  • CD для вашего расширения и zephir build
  • Возьмите построенный .dll из your_ext/Release/php_extname.dll (или your_ext/Release_TS/php_extname.dll)

Дополнительные ссылки

Содержание.

Предыдущая  Следущая.