Symfony與CI/CD流程集成

Symfony 是一個用于開發 Web 應用程序的 PHP 框架，而 CI/CD（持續集成/持續部署）是一種自動化軟件交付方法。將 Symfony 與 CI/CD 流程集成可以幫助你更高效地開發和部署應用程序。以下是一個基本的步驟指南，幫助你實現這一目標：

1. 設置版本控制系統

首先，確保你的項目已經使用 Git 進行版本控制。你可以通過以下命令初始化一個 Git 倉庫：

git init

2. 創建 Symfony 項目（如果尚未創建）

如果你還沒有創建 Symfony 項目，可以使用 Composer 創建一個新的項目：

composer create-project symfony/website-skeleton my-project
cd my-project

3. 配置 CI/CD 工具

選擇一個 CI/CD 工具，例如 Jenkins、GitLab CI/CD、GitHub Actions 等。這里以 GitHub Actions 為例。

3.1 創建 GitHub Actions 工作流

在你的項目根目錄下創建一個 .github/workflows 文件夾，并在其中創建一個新的 YAML 文件，例如 ci.yml。

name: CI

on: [push]

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v2
    - name: Set up PHP
      uses: actions/setup-php@v2
      with:
        php-version: '7.4'
    - name: Install dependencies
      run: composer install --no-interaction --prefer-dist
    - name: Run tests
      run: vendor/bin/phpunit --coverage-clover build/logs/clover.xml

這個工作流會在每次推送代碼到 GitHub 時觸發，并執行以下步驟：

1. 克隆代碼倉庫。
2. 設置 PHP 環境。
3. 安裝項目依賴。
4. 運行單元測試并生成代碼覆蓋率報告。

4. 配置 Symfony 命令行工具

確保你的 Symfony 項目已經配置了命令行工具。你可以通過以下命令生成一個 bin/console 文件：

php bin/console make:command YourCommandName

5. 創建自定義 CI/CD 命令

你可以創建自定義的 Symfony 命令來執行特定的 CI/CD 任務，例如構建、測試或部署。

5.1 創建自定義命令

在你的 Symfony 項目中創建一個新的命令類，例如 src/Command/CustomCiCommand.php：

namespace App\Command;

use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;

class CustomCiCommand extends Command
{
    protected function configure()
    {
        $this
            ->setName('custom:ci')
            ->setDescription('Run custom CI/CD tasks');
    }

    protected function execute(InputInterface $input, OutputInterface $output)
    {
        // 在這里執行你的 CI/CD 任務
        $output->writeln('Running custom CI/CD tasks...');
    }
}

5.2 注冊自定義命令

在你的 app/Console/Kernel.php 文件中注冊這個自定義命令：

protected $commands = [
    // ...
    Commands\CustomCiCommand::class,
];

6. 集成自定義命令到 CI/CD 工作流

修改你的 GitHub Actions 工作流文件，以運行自定義的 CI/CD 命令。例如：

name: CI

on: [push]

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v2
    - name: Set up PHP
      uses: actions/setup-php@v2
      with:
        php-version: '7.4'
    - name: Install dependencies
      run: composer install --no-interaction --prefer-dist
    - name: Run custom CI/CD command
      run: ./bin/console custom:ci

7. 部署應用程序

你可以使用 Symfony 的內置部署功能或第三方工具（如 Docker、Kubernetes 等）來部署你的應用程序。以下是一個簡單的示例，使用 php bin/console doctrine:migrations:migrate 命令來應用數據庫遷移：

name: Deploy

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v2
    - name: Set up PHP
      uses: actions/setup-php@v2
      with:
        php-version: '7.4'
    - name: Install dependencies
      run: composer install --no-interaction --prefer-dist
    - name: Run database migrations
      run: ./bin/console doctrine:migrations:migrate

通過以上步驟，你可以將 Symfony 與 CI/CD 流程集成，實現自動化構建、測試和部署。根據你的具體需求，你可以進一步擴展和優化這個流程。