PHP
Websoft9 将 Docker 官方的 php 镜像以模板化的方式，集成到 Websoft9 控制台，实现自动化的部署和发布 PHP 应用程序。
主要的功能包括：
- 100% 可视化操作
- 配置文件和应用程序数据持久化
- 提供了 PHP + Apache(mod-php) 、PHP-FPM + NGINX 和 PHP-FPM + Apache 三个可选的运行环境
- 支持 Dockerfile 编写和自动构建、运行
- 预制容器启动后运行的脚本
cmd.sh，便于用户实现自动化部署 - 支持 php 模块以及 apt 包的申明式安装
- phar 包支持
- 支持的缓存扩展：OPcache, XCache, APCU, eAccelerator
- 框架：Symfony, Laravel, CodeIgniter, Yii 等
- 应用：WordPress, Joomla, Drupal 等
- 支持 PHP 多版本切换
配置选项
配置文件路径和修改
PHP 程序环境对应的主要路径与配置文件一览表如下：
| 项 | 容器内路径 | 挂载路径 |
|---|---|---|
| 应用根目录 | /var/www/html | 名称为 source 的 Docker 卷 |
| 自动化脚本文件 | /usr/local/bin/cmd.sh | 应用 Git 仓库下 src/cmd.sh |
| PHP 配置文件 | /usr/local/etc/php/conf.d/php_extra.ini | 应用 Git 仓库下 `src/php_extra.ini |
| 扩展申明式配置文件 | Dockerfile 构建时解析配置并安装包 | 应用 Git 仓库下 `src/extensions.ini |
| Apache 配置文件 | /etc/apache2/sites-available/000-default.conf | 应用 Git 仓库下 `src/000-default.conf* |
| NGINX 配置文件 | /etc/nginx/sites-available/default | 应用 Git 仓库下 src/nginx.conf |
| NGINX 配置目录 | /etc/nginx/conf.d | 名称为 nginx_conf 的 Docker 卷 |
| PHP-FPM 配置文件 | /usr/local/etc/php-fpm.d/fpm_extra.conf | 应用 Git 仓库下 `src/fpm_extra.conf |
-
挂载到应用 Git 仓库下的配置文件，请选择一种配置方式：
- 在 Websoft9 控制台通过 编排 操作进行修改，重建应用后持久生效
- 在 Websoft9 控制台 exec 到容器，通过 vim 命令修改可临时生效，重建应用后会丢失配置
-
挂载到 Docker 卷的配置项目，请在对应的目录中增加配置文件，重启应用后持久生效
其他配置说明
- 应用目录用户：www-data
- PHP 大版本切换（√）：切换后需重建容器，并根据需要重新安装 PHP 扩展
- 多应用支持：一个 PHP 容器仅支持一个应用，多个应用建议运行多个 PHP 容器
- php-fpm 和 mod-php 容器可选
- 命令行：
php：PHP 标准命令，例如php -m查看已安装的 PHP 扩展composer：PHP 包管理器命令install-php-extensions：安装 PHP 扩展的命令行，它支持数百种 php 包，首选推荐它docker-php-ext-install,pecl：其他包管理工具
部署网站
环境管理
数据持久化
由于 Websoft9 PHP Runtime 是基于 Docker 容器，故用户需要特别注意数据的持久化问题：
- 所有的配置均以声明式的方式存放到 PHP 应用的对应的 Git 仓库中，虽然它们是持久化的，但需重建应用才可将更改在容器中生效
- 通过修改
cmd.sh脚本实现自动化部署时，用户需编写应用重建时数据可迁移的程序段
安装 PHP 扩展
Websoft9 提供了申明式安装 PHP 扩展以及操作系统包的功能，大大简化用户安装包的困扰：
-
登录 Websoft9 控制台，对正在运行的 PHP 容器应用进行 编排 操作
-
修改
src/extensions.ini文件，根据扩展安装方式，向其中增加所需的扩展名称-
install-php-extensions：这是 Websoft9首选推荐的方式。先查询支持的 php 包名 ，然后将包名称增加到此配置项中
-
docker-php-ext-install 和 pecl 两种包安装方式，请参考 php 官方镜像 的使用方法。
-
-
重建应用后生成新的镜像，并基于新镜像启动容器
-
运行
php -m查看扩展的安装情况
也可以 docker exec 到 php 容器后，运行
install-php-extensions mysqli jd命令直接安装扩展。但是，容器重建后扩展会丢失。
问题与故障
PHP 7.0 以下 apt update 报错？
原因：PHP7.0 以下的容器 Debian 操作系统版本太旧，导致源不可用
方案：需要重新设定源
sed -i s/deb.debian.org/archive.debian.org/g /etc/apt/sources.list
sed -i 's|security.debian.org|archive.debian.org|g' /etc/apt/sources.list
sed -i '/stretch-updates/d' /etc/apt/sources.list
应用目录没有写权限？
容器中运行 chown -R www-data:www-data /var/www/html 修正权限即可
应用根目录可更换吗？
修改 Apache 配置文件中的 DocumentRoot 项，即可更换目录。但是新的目录必须是 /var/www/html 的子目录，例如：/var/www/html/laravel/public
支持应用 .htaccess 中修改 php.ini？
支持
PHP 扩展为何对操作系统有依赖？
PHP 的扩展（extension）这里应称为“模块（module）”是 C、C++ 编写的功能合集，扩展大多以动态链接 .dll、.so 形式加载。php扩展是php核心并不支持的功能，然后可以通过扩展的方式进行扩展PHP的功能，常见的扩展如MySQL，gb2等等。