Ansible自动部署PHP环境配置指南

Ansible通过YAML Playbook实现PHP环境自动化部署和配置标准化。1. 安装Ansible并配置SSH免密登录；2. 编写Playbook定义PHP版本、扩展及配置任务，如安装PHP包、配置PHP-FPM、创建Web根目录；3. 使用Jinja2模板生成配置文件；4. 运行Playbook并验证部署结果。可通过定义多个PHP版本并结合循环安装实现多版本管理，Ansible的apt模块自动处理依赖，部署应用时可结合git和composer模块完成代码克隆与依赖安装。

Ansible可以帮你实现PHP环境的自动化部署和服务器配置标准化，告别手动配置的繁琐和不一致。它通过简单的YAML文件定义你的环境，然后像魔法一样，让所有服务器都变成你想要的样子。

解决方案：

1. 安装Ansible： 废话不多说，pip install ansible 或者用你喜欢的包管理器安装。确保你的控制节点（运行Ansible的机器）可以SSH免密登录到所有目标服务器。

   

2. 编写Playbook： 这是核心。创建一个YAML文件（比如php_deploy.yml），定义你的PHP环境。

   ---
   - hosts: all
     become: true  # 相当于sudo
     vars:
       php_version: "8.1"  # 可以根据需要修改版本
       web_root: /var/www/html
     tasks:
       - name: Update apt cache
         apt:
           update_cache: yes
           cache_valid_time: 3600
   
       - name: Install PHP and required extensions
         apt:
           name:
             - php{{ php_version }}-fpm
             - php{{ php_version }}-cli
             - php{{ php_version }}-mysql  # 常用扩展
             - php{{ php_version }}-curl
             - php{{ php_version }}-gd
             - php{{ php_version }}-mbstring
             - php{{ php_version }}-xml
             - php{{ php_version }}-zip
           state: present
         notify: restart php-fpm
   
       - name: Configure PHP-FPM pool
         template:
           src: templates/php-fpm.conf.j2
           dest: /etc/php/{{ php_version }}/fpm/pool.d/www.conf
           owner: root
           group: root
           mode: 0644
         notify: restart php-fpm
   
       - name: Ensure web root directory exists
         file:
           path: "{{ web_root }}"
           state: directory
           owner: www-data
           group: www-data
           mode: 0755
   
     handlers:
       - name: restart php-fpm
         service:
           name: php{{ php_version }}-fpm
           state: restarted

   解释一下：

   
   • hosts: all 表示这个Playbook应用到所有主机（需要在Ansible的inventory文件中定义）。
   • become: true 表示使用sudo权限。
   • vars 定义变量，方便修改。
   • tasks 是任务列表，每个任务执行一个操作。
   • apt 模块用于安装软件包。
   • template 模块用于复制模板文件，并进行变量替换。
   • notify 表示在任务完成后触发handler。
   • handlers 定义handler，用于重启PHP-FPM。

3. 创建模板文件： templates/php-fpm.conf.j2 (这是一个Jinja2模板)。

   ; Pool configuration for www
   
   [www]
   
   user = www-data
   group = www-data
   
   listen = 127.0.0.1:9000
   listen.owner = www-data
   listen.group = www-data
   
   pm = dynamic
   pm.max_children = 5
   pm.start_servers = 2
   pm.min_spare_servers = 1
   pm.max_spare_servers = 3
   
   chdir = /
   
   ; Redirect worker stdout and stderr into main log file. If not set, stdout and
   ; stderr will be redirected to /dev/null according to FastCGI specs.
   ; Default Value: not set
   ; stderr_path = /var/log/php-fpm/www-error.log
   
   ; Slow log
   ; slowlog = /var/log/php-fpm/www-slow.log

   这个模板定义了PHP-FPM的配置，可以根据你的需求进行修改。

4. 运行Playbook： ansible-playbook php_deploy.yml

   Ansible会连接到你的服务器，执行Playbook中定义的任务。

5. 验证： 登录到你的服务器，检查PHP是否安装成功，配置文件是否正确。

如何使用Ansible管理多个PHP版本？

可以在Playbook中使用vars定义不同的PHP版本，然后使用with_items循环安装不同版本的PHP。例如：

---
- hosts: all
  become: true
  vars:
    php_versions:
      - "7.4"
      - "8.1"
  tasks:
    - name: Install PHP versions
      apt:
        name:
          - "php{{ item }}-fpm"
          - "php{{ item }}-cli"
        state: present
      loop: "{{ php_versions }}"

这样就可以同时安装PHP 7.4和PHP 8.1。当然，你需要调整PHP-FPM的配置，确保不同版本的PHP-FPM监听不同的端口。

Ansible如何处理PHP扩展的依赖关系？

Ansible的apt模块会自动处理依赖关系。你只需要在name参数中列出所有需要安装的扩展，Ansible会自动安装它们依赖的软件包。如果遇到依赖问题，可以尝试更新apt缓存：

- name: Update apt cache
  apt:
    update_cache: yes
    cache_valid_time: 3600

另外，有些扩展可能需要手动安装一些系统库，需要在安装扩展之前先安装这些库。

如何使用Ansible部署PHP应用程序？

可以使用git模块从Git仓库克隆代码到服务器，然后使用composer模块安装依赖。例如：

---
- hosts: all
  become: true
  vars:
    app_root: /var/www/my_app
    repo_url: git@github.com:your_username/your_repo.git
  tasks:
    - name: Clone repository
      git:
        repo: "{{ repo_url }}"
        dest: "{{ app_root }}"
        version: main  # 或者指定分支、tag
        force: yes

    - name: Install composer dependencies
      composer:
        command: install
        working_dir: "{{ app_root }}"
      become: false # composer 通常不需要root权限

注意，你需要确保服务器上已经安装了Git和Composer。另外，become: false 表示不使用sudo权限运行Composer，因为Composer通常不需要root权限。