跳到主要内容
版本：2.0

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：其他包管理工具

部署网站​

参考：Web Runtime 入门指南

环境管理​

数据持久化​

由于 Websoft9 PHP Runtime 是基于 Docker 容器，故用户需要特别注意数据的持久化问题：

  • 所有的配置均以声明式的方式存放到 PHP 应用的对应的 Git 仓库中，虽然它们是持久化的，但需重建应用才可将更改在容器中生效
  • 通过修改 cmd.sh 脚本实现自动化部署时，用户需编写应用重建时数据可迁移的程序段

安装 PHP 扩展​

Websoft9 提供了申明式安装 PHP 扩展以及操作系统包的功能，大大简化用户安装包的困扰：

  1. 登录 Websoft9 控制台，对正在运行的 PHP 容器应用进行 编排 操作

  2. 修改 src/extensions.ini 文件，根据扩展安装方式，向其中增加所需的扩展名称

    • install-php-extensions：这是 Websoft9首选推荐的方式。先查询支持的 php 包名 ，然后将包名称增加到此配置项中

    • docker-php-ext-install 和 pecl 两种包安装方式，请参考 php 官方镜像 的使用方法。

  3. 重建应用后生成新的镜像，并基于新镜像启动容器

  4. 运行 php -m 查看扩展的安装情况

也可以 docker exec 到 php 容器后，运行 install-php-extensions mysqli jd 命令直接安装扩展。但是，容器重建后扩展会丢失。

Command 示例​

# Install the latest version
install-php-extensions mysqli jd
install-php-extensions @composer

# Install the latest 1.x version
install-php-extensions @composer-1

# Install a specific version
install-php-extensions @composer-2.0.2

# pecl install extensions
pecl install redis-5.3.7; docker-php-ext-enable redis

问题与故障​

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等等。

docker-php-ext-install gd 不可用？​

问题描述： docker-php-ext-install gd 后，php -m 查询有 gd 模块，但是通过 <?php phpinfo(); ?> 无法显示 gd 模块安装成功的结果
问题原因： docker-php-ext-install gd 这个命令依赖于操作系统的包，需要提前安装相关的图形包

apt-get update && apt-get install -y \
	libfreetype-dev \
	libjpeg62-turbo-dev \
	libpng-dev