Rainbond可以将PHP源码快速的部署并运行起来。无论是Symfony、Laravel 或 ThinkPHP 等开发框架，还是使用非开发框架，或者通过环境配置文件自定义Web Server与PHP环境。

一、代码识别

代码的根目录下有 index.php 文件或者 composer.json文件，rainbond构建程序会识别为PHP语言。

提示:

如果根目录存在composer.lock文件会优化读取composer.lock的配置，忽略掉 composer.json，需删除composer.phar

二、支持版本

平台提供了不同的PHP版本，您可以使用PHP，HHVM(PHP代码编译器)，或者同时使用二者，通过HHVM提高PHP性能。

2.1 PHP版本

• PHP 5.5 (5.5.38)
• PHP 5.6 (5.6.11, 5.6.30, 5.6.35)(默认)
• PHP 7.0 (7.0.16, 7.0.29)
• PHP 7.1 (7.1.2, 7.1.16)

2.2 HHVM版本

• HHVM 3.5.1

2.3 选择PHP版本

有两种方式指定PHP版本：

• 通过平台创建应用向导中选择。
• 通过配置composer.json文件来实现：
• 在您代码的根目录创建composer.json文件，指定使用PHP 5.6.35版本，文件具体内容如下：

copy

{
    "require": {"php": "5.6.35"}
}

• 在您代码的根目录创建composer.json配置并使用HHVM 3.5.1版本：

copy

{
    "require": {"hhvm": "3.5.1"}
}

提示:

PHP 的版本支持 ~5.5.35 这种 Semantic Versioning 的形式，如果用户指定~5.5.35系统会从平台中选择5.5分支版本最高的版本，因此会选择5.5.35版本。

2.4 扩展

云帮创建PHP应用时支持添加扩展。您可以在创建应用时通过向导提供的扩展进行选择添加；或者自定义扩展，云帮会在构建过程中将您自定义的扩展添加：

2.4.1 默认扩展

以下为云帮创建PHP应用时默认开启的扩展：

• Bzip2
• cURL
• FPM
• mcrypt
• MySQL(PDO) (使用 mysqlnd)
• MySQLi (使用 mysqlnd)
• OPcache
• OpenSSL
• PostgreSQL
• PostgreSQL(PDO)
• Readline
• Sockets
• Zip
• Zlib

2.4.2 可选扩展

您可以在应用创建的向导中选择添加除默认扩展外的其他扩展(扩展名对应包名在下列括号中给出)：

• BCMath(bcmath)
• Calendar(calendar)
• Exif(exif)
• FTP(ftp)
• GD(gd)
• gettext(gettext)
• intl(intl)
• mbstring(mbstring)
• MySQL(mysql，注意，该扩展已经在php 5.5中废弃,推荐使用 MySQLi 或 PDO)
• PCNTL(pcntl)
• Shmop(shmop)
• SOAP(soap)
• SQLite3(sqlite3)
• SQLite(PDO)(pdo_sqlite)
• XMLRPC(xmlrpc)
• XSL(xsl)

2.4.3 自定义扩展

您可以在composer.json中添加自定义扩展，这里需要以 ext-(前缀) +**扩展包名 这样的格式命名扩展包名称，使用 * 标识扩展包的版本号。以下是使用bcmath, Memcached, MongoDB和 XSL 的例子：

copy

{
    "require": {
        "ext-bcmath": "*",
        "ext-memcached": "*",
        "ext-mongo": "*",
        "ext-xsl": "*"
    }
}

提示:

composer是PHP的依赖管理器，composer.json则是composer的配置文件，强烈建议使用 “*” 来标识扩展包的版本号。

2.4.4 第三方扩展

以下第三方扩展可以通过 composer.json 开启（包名已在括号内给出）：

• APCu(apcu)(apcu)
• ImageMagick(imagick)(imagick)
• memcached(memcached)
• MongoDB(mongo)
• New Relic(newrelic)
• PHPRedis(redis)
• Yaf(yaf)
• Phalcon(phalcon)

提示:

HHVM 暂时不支持自定义扩展

2.4.5 扩展特例

官方出品过2个mongodb的扩展，一个叫mongo，一个是mongodb。前者已经被官方废弃，不再提供稳定的更新，官方推荐使用后者，并且后者是支持php7的。所以在使用mongodb扩展时，需要在composer.json中指定扩展为mongodb。

copy

{
    "require": {
                "php": "~7.1.16",
                "ext-memcached": "*",
                "ext-mongodb": "*",
                "ext-mbstring": "*"
    }
}

三、构建

在部署期间系统会运行以下命令来安装依赖包，解决依赖关系：

composer install --no-dev --prefer-dist --optimize-autoloader --no-interaction

提示:

系统会在每次运行的时候使用composer self-update 将composer自动更新到最新版本。

四、Web 服务器

云帮支持 Apache 和 Nginx 两种 Web 服务器，如果您在Profile文件中没有设置加载其中任一服务器，或代码根目录没有 Procfile 文件，应用创建向导会提示用户选择Apache或Nginx作为Web服务器。

4.1 Apache服务器

Apache接口与PHP-FPM或HHVM通过FastCGI使用 mod_proxy_fcgi。

名词释义：

FastCGI：快速网关接口，是一种让交互程序与Web服务器通信的协议，早期通用网关接口(CGI)的增强版本

PHP-FPM：是一个FastCGI管理器，旨在将FastCGI进程管理整合进PHP包中

HHVM：PHP代码编译器

在您代码的根目录下创建 Procfile 文件，填写以下内容来开启 PHP-FPM：

web: vendor/bin/heroku-php-apache2

如果要运行 HHVM 的话，Procfile 内容如下：

web: vendor/bin/heroku-hhvm-apache2

您可以通过 .htaccess 文件来自定义 Apache 的行为，也可以使用自定义 Apache 配置文件的方式。例如；

将以下内容保存在根目录下命名为 apache_app.conf：

RewriteEngine On
RewriteCond %{REQUEST_URI}::$1 ^(/.+)/(.*)::\2$
RewriteRule ^(.*) - [E=BASE:%1]
RewriteCond %{ENV:REDIRECT_STATUS} ^$
RewriteRule ^app\.php(/(.*)|$) %{ENV:BASE}/$2 [R=301,L]
RewriteCond %{REQUEST_FILENAME} -f
RewriteRule .? - [L]
RewriteRule .? %{ENV:BASE}/app.php [L]

然后修改 Procfile 文件加载此配置：

web: vendor/bin/heroku-php-apache2 -C apache_app.conf

4.2 Nginx

Nginx 使用 FastCGI 连接 PHP-FPM，使用下面的 Procfile 开启 Nginx：

web: vendor/bin/heroku-php-nginx

如果要运行 HHVM 的话，Procfile 内容如下：

web: vendor/bin/heroku-hhvm-nginx

Nginx 服务器同样支持自定义配置，以下是一个 URL 重写的例子：

location / {
    # try to serve file directly, fallback to rewrite
    try_files $uri @rewriteapp;
}
location @rewriteapp {
    # rewrite all to app.php
    rewrite ^(.*)$ /app.php/$1 last;
}
location ~ ^/(app|app_dev|config)\.php(/|$) {
    fastcgi_pass heroku-fcgi;
    fastcgi_split_path_info ^(.+\.php)(/.*)$;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_param HTTPS off;
}

将其保存在根目录下命名为为 nginx_app.conf ，修改 Procfile 文件为以下内容即可：

web: vendor/bin/heroku-php-nginx -C nginx_app.conf

五、PHP示例代码

• php示例代码

六、相关文档

• 自定义Web Server与PHP环境
• Procfile文件说明