2023年的PHP專案部署筆記。什麼？還有人用PHP？

程式設計實驗室發表於2023-12-12

PHP筆記

前言

這是我第一次用 PHP 的包管理工具 composer

一開始用 docker 進行部署，但一直出問題，最後還是選擇直接在伺服器上安裝 php-fpm 搭配 nginx 的方案了。

PS：docker方式真的搞得心好累，現在回想起來還心有餘悸😢

docker方案

先把我的 docker 方案放上來吧，畢竟也折騰了好久，處於基本可用的狀態。

目錄結構

目錄結構如下

php-code
 ├─ log  // 日誌
 │  ├─ nginx
 │  └─ php
 ├─ conf  // 配置
 │  ├─ nginx
 │  │  ├─ nginx.conf
 │  │  └─ test.conf
 │  └─ php
 │     ├─ conf.d
 │     │  └─ docker-php-ext-xdebug.ini
 │     ├─ php-fpm.conf
 │     └─ php.ini
 ├─ code // PHP程式碼
 ├─ docker-compose.yml
 ├─ Dockerfile
 └─ .env

nginx配置

server {
    listen 8080;
    server_name localhost;
    root /usr/share/nginx/html/public;
    index index.php index.html index.htm;

    charset utf-8;
    client_max_body_size 100M;

    location ~ \.php$ {
        fastcgi_pass   php-fpm:9000;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME  /var/www/html/public$fastcgi_script_name;
        fastcgi_param  SCRIPT_NAME      $fastcgi_script_name;
        include        fastcgi_params;
    }

    location / {
        if (!-e $request_filename){
        rewrite  ^(.*)$  /index.php?s=$1  last;   break;
        }
    }
}

access_log /var/log/nginx/access.log main;
error_log /var/log/nginx/error.log warn;

server_tokens off;

PHP配置

主要是開啟除錯日誌，可以看到程式執行的時候有什麼報錯

docker-php-ext-xdebug.ini

xdebug.remote_enable = On
xdebug.remote_handler = dbgp
xdebug.remote_host = host.docker.internal
xdebug.remote_port = 9001
xdebug.remote_log = /var/log/php/xdebug.log
xdebug.idekey = PHPSTOR

php-fpm.conf

[global]
error_log = /proc/self/fd/2


; https://github.com/docker-library/php/pull/725#issuecomment-443540114
log_limit = 8192

[www]
; if we send this to /proc/self/fd/1, it never appears
access.log = /proc/self/fd/2

clear_env = no

; Ensure worker stdout and stderr are sent to the main error log.
catch_workers_output = yes
decorate_workers_output = no

php.ini

log_errors=On

dockerfile

構建docker映象，這個專案要求的PHP版本是7.4

讓我感到很奇怪的是 PHP 的官方映象里居然沒有 composer，還得自己折騰。

這個 dockerfile 參考了很多文章部落格，結果發現還不如自己折騰一下，已知問題是 gd 外掛安裝沒有生效，猜測是還需要使用 apt 安裝 php-gd，然後 docker-php-ext-install 才能生效。

FROM composer:2.2 as composer
FROM php:7.4.33-fpm as php

# 映象資訊
LABEL Author="DealiAxy"
LABEL Version="2023.11"
LABEL Description="PHP 7-fpm 開發環境映象."

# 更新為國內映象
RUN apt install apt-transport-https ca-certificates \ 
    && mv /etc/apt/sources.list /etc/apt/sources.list.bak \
    && echo "Acquire::http::Pipeline-Depth \"0\";" > /etc/apt/apt.conf.d/99nopipelining \
    && echo 'deb http://mirrors.tuna.tsinghua.edu.cn/debian/ bullseye main contrib non-free' > /etc/apt/sources.list \
    && echo 'deb http://mirrors.tuna.tsinghua.edu.cn/debian/ bullseye-updates main contrib non-free' >> /etc/apt/sources.list \
    && echo 'deb http://mirrors.tuna.tsinghua.edu.cn/debian/ bullseye-backports main contrib non-free' >> /etc/apt/sources.list \
    && apt-get update

# bcmath, calendar, exif, gettext, sockets, dba,
# mysqli, pcntl, pdo_mysql, shmop, sysvmsg, sysvsem, sysvshm 擴充套件
RUN docker-php-ext-install -j$(nproc) bcmath calendar exif gettext sockets dba mysqli pcntl pdo_mysql shmop sysvmsg sysvsem sysvshm iconv

RUN apt update && apt-get install -y git zip libpng-dev libzip-dev && \
    rm -rf /var/lib/apt/lists/* && \
    ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
    docker-php-ext-install pdo pdo_mysql mysqli gd zip bcmath opcache && \
    docker-php-ext-enable mysqli gd

# 複製程式碼
COPY --chown=www-data:www-data ./code /var/www/html

# copy vender
COPY --from=composer /usr/bin/composer /usr/bin/composer

WORKDIR /var/www/html

RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ \
    && composer config -g --unset repos.packagist \
    && composer install \
    && ls -la


EXPOSE 9000
CMD ["php-fpm"]

環境變數 .env

APP_NAME=php-oa

docker-compose

version: "3.6"
services:
  nginx:
    image: nginx:stable-alpine
    container_name: ${APP_NAME}_nginx
    restart: unless-stopped
    volumes:
      - ./conf/nginx/nginx.conf:/etc/nginx/conf.d/default.conf
      - ./code:/usr/share/nginx/html
      - ./log/nginx:/var/log/nginx
    ports:
      - "8080:8080"
    depends_on:
      - php-fpm
    networks:
      - default
      - swag
  php-fpm:
    build: .
    user: 'www-data:www-data'
    container_name: ${APP_NAME}-php
    restart: unless-stopped
    volumes:
    # - ./conf/php:/usr/local/etc/php
      - ./code/public:/var/www/html/public
      - ./conf/php/php-fpm.conf:/usr/local/etc/php-fpm.d/docker.conf
      - ./conf/php/php.ini:/usr/local/etc/php/php.ini
      - ./log/php:/var/log/php
    networks:
      - default

networks:
  swag:
    name: swag
    external: true
  default:
    name: ${APP_NAME}

直接部署方案

這是最容易的方案

我的伺服器是 Ubuntu 22.04 ，官方源的 PHP 是8.1版本，這裡需要新增 PPA 才能使用 7.4 版本。

新增 PPA 源

sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php -y
sudo apt update

安裝PHP7.4

並且把常用擴充套件也安裝了

sudo apt install php7.4 php7.4-fpm
sudo apt install php7.4-{cli,common,curl,zip,gd,mysql,xml,mbstring,json,intl}

裝完檢視狀態

sudo systemctl status php7.4-fpm.service

安裝和配置 nginx

安裝就不多說了

直接配置

在 /etc/nginx/sites-available 裡增加一個配置檔案

這裡的檔名是 php.conf

我們把 PHP 程式碼放在 /var/www/html/php-code

設定網站根目錄為 PHP 程式碼下的 public 目錄 （這是這個專案設計成這樣的）

server {

    server_name domain.com;
    listen 8081;
    root /var/www/html/php-code/public;
    index index.php index.html index.htm;

    charset utf-8;
    client_max_body_size 100M;

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php-fpm.sock;
    }

    location / {
        if (!-e $request_filename){
        rewrite  ^(.*)$  /index.php?s=$1  last;   break;
        }
    }
}

安裝 composer 和安裝依賴

使用 composer 安裝依賴

如果沒有這一步的話，那就跟5、6年前在使用 PHP 的時候沒有區別

官方地址

可以直接透過官方源安裝，並且使用 php 直接執行安裝指令碼

sudo apt-get install curl
sudo apt-get install php php-curl
curl -sS https://getcomposer.org/installer -o composer-setup.php
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
sudo composer self-update

國內源

透過國內源下載二進位制檔案

curl https://mirrors.cloud.tencent.com/composer/composer.phar -o /usr/local/bin/composer
curl https://mirrors.aliyun.com/composer/composer.phar -o /usr/local/bin/composer
chmod +x /usr/local/bin/composer

檢查 composer

composer -v

配置映象

得先配置一下國內映象，可以參考這個專案: https://github.com/china-speed/china-speed.github.io

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
composer config -g --unset repos.packagist

安裝依賴

cd /var/www/html/php-code
composer install

搞定

處理許可權問題

不知道是不是所有 PHP 專案都喜歡在專案下面建立和修改檔案，這也給docker部署方式帶來了不小的挑戰

直接在系統上部署好一點，首先把程式碼目錄所有者轉移給 www-data 使用者

chown -R www-data:www-data /var/www/html

為了本使用者也能寫入，新增一下使用者組

usermod -a -G www-data {username}

對了，PHP檔案還需要可執行許可權才行……

chmod -R u+rwx /var/www/html/php-code

給組內的使用者也新增一下讀寫許可權

chmod -R g+rw /var/www/html/php-code

基本就搞定了。

使用 ThinkPHP 框架的後端也不存在什麼啟動後端服務的概念，直接這樣把程式碼放在目錄裡就搞定了，直接訪問即可。

參考資料

【PHP】Largon 快速部署 Laravel 專案
2022-12-27
PHPGoLaravel
PHP - 什麼是 PHP? 為什麼用 PHP? 有誰在用 PHP?
2023-04-18
PHP
在 Windows 上使用 IIS 部署 PHP 專案
2019-01-13
WindowsPHP
快速上手php：使用PhpStrom部署專案
2015-11-25
PHP
php檔案鎖是什麼
2021-09-11
PHP
【PHP】PHP專案製作
2014-11-10
PHP
【PHP】英文部落格專欄PHP快速入門個人筆記
2023-01-27
PHP筆記
PHP SPL 筆記
2019-02-16
PHP筆記
PHP SPL筆記
2008-07-08
PHP筆記
nginx+php-fpm獨立節點的部署wordpress筆記
2017-11-21
NginxPHP筆記
自學PHP筆記（一）PHP語法
2021-04-12
PHP筆記
自學PHP筆記(五) PHP運算子
2021-04-18
PHP筆記
什麼是PHP
2019-10-16
PHP
自學PHP筆記(一)PHP基本語法
2021-04-06
PHP筆記
《PHP學習筆記——PHP基本語法》
2018-04-21
PHP筆記
php相關筆記
2018-10-12
PHP筆記
php 學習筆記
2017-12-03
PHP筆記
PHP學習筆記
2011-04-08
PHP筆記
apache 部署多 PHP 版本、多專案以及二級域名
2018-01-24
ApachePHP
PHP是什麼-PHP的架構及原理概述
2018-02-25
PHP架構
非同步 PHP:為什麼? ( Asynchronous PHP: Why?)
2019-11-14
非同步PHP
自學PHP筆記(四) PHP變數和常量
2021-04-12
PHP筆記變數
自學PHP筆記(四) PHP常量和變數
2021-04-10
PHP筆記變數
自學PHP筆記（二）PHP資料型別
2021-04-06
PHP筆記資料型別
PHP建立laravel專案
2018-05-25
PHPLaravel
什麼是PHP Guzzle?
2015-08-02
PHP
為什麼PHP檔案一般沒有結束標記
2012-10-16
PHP
PHP+sqlserver搭建筆記
2019-02-16
PHPSQLServer筆記
安裝PHP ImageMagick筆記
2018-12-29
PHP筆記
引用-PHP手冊筆記
2015-06-19
PHP筆記
什麼是PHP或PHP程式碼以及PHP程式設計的工作原理
2019-02-01
PHP程式設計
記錄安裝 Laravel 專案遇到多版本 PHP 的坑
2020-07-01
LaravelPHP
為什麼HTML不能巢狀PHP,而PHP檔案卻可以巢狀HTML
2018-12-15
HTML巢狀PHP
將寶塔PHP專案下載到本地部署之nginx配置
2022-06-15
PHPNginx
如何開啟php專案
2021-09-11
PHP
PHP-FPM 是什麼？
2021-01-14
PHP
PHP需要改變什麼
2011-07-06
PHP
什麼是CGI、FastCGI、PHP-CGI、PHP-FPM
2019-02-16
ASTPHP