境搭建：容器化部署PHP項(xiàng)目的完整實(shí)踐指南)
1. 項(xiàng)目概述為什么選擇Docker來搭建LNMP如果你是一名后端開發(fā)者、運(yùn)維工程師或者正在學(xué)習(xí)Web開發(fā)那么“LNMP”這個組合對你來說一定不陌生。它代表了Linux、Nginx、MySQL和PHP是構(gòu)建動態(tài)網(wǎng)站最經(jīng)典、最穩(wěn)定的技術(shù)棧之一。傳統(tǒng)的LNMP環(huán)境搭建通常意味著我們需要在服務(wù)器上手動安裝和配置這四大組件處理各種依賴、版本沖突和權(quán)限問題過程繁瑣且容易出錯一旦系統(tǒng)環(huán)境變化遷移和復(fù)現(xiàn)更是頭疼。這正是Docker大顯身手的地方。Docker通過容器化技術(shù)將應(yīng)用及其所有依賴打包在一個獨(dú)立的、可移植的“容器”中。對于LNMP環(huán)境搭建來說這意味著我們可以將Nginx、MySQL、PHP分別封裝在獨(dú)立的容器里它們彼此隔離互不干擾。你需要哪個版本的PHP7.4還是8.2直接拉取對應(yīng)的鏡像即可。想在同一臺服務(wù)器上運(yùn)行多個不同配置的項(xiàng)目容器間的網(wǎng)絡(luò)和存儲可以輕松隔離和管理。所以今天我要分享的就是如何在Linux系統(tǒng)下使用Docker從零開始搭建一個完整的LNMP環(huán)境并部署一個實(shí)際的PHP項(xiàng)目。整個過程我會拆解得非常細(xì)致從Docker的基本操作講起到每個服務(wù)的容器化配置、容器間的網(wǎng)絡(luò)通信、數(shù)據(jù)持久化最后完成項(xiàng)目的部署和訪問。無論你是Docker新手還是有一定經(jīng)驗(yàn)想尋求更佳實(shí)踐這篇內(nèi)容都能給你提供一條清晰的路徑和許多實(shí)操中積累下來的細(xì)節(jié)技巧。2. 環(huán)境準(zhǔn)備與Docker基礎(chǔ)在開始搭建之前我們需要一個干凈的Linux環(huán)境。我使用的是Ubuntu 22.04 LTS但CentOS、Debian等主流發(fā)行版的步驟也大同小異。核心是確保Docker能夠正確安裝和運(yùn)行。2.1 Docker安裝與驗(yàn)證首先我們需要安裝Docker Engine。這里我推薦使用官方提供的安裝腳本它比通過系統(tǒng)包管理器安裝通常能獲得更新的版本。打開終端執(zhí)行以下命令來安裝Docker# 1. 卸載舊版本如果存在 sudo apt-get remove docker docker-engine docker.io containerd runc # 2. 更新apt包索引并安裝依賴 sudo apt-get update sudo apt-get install -y ca-certificates curl gnupg lsb-release # 3. 添加Docker官方GPG密鑰 sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg # 4. 設(shè)置穩(wěn)定版?zhèn)}庫 echo \ deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null # 5. 安裝Docker Engine sudo apt-get update sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin安裝完成后運(yùn)行下面的命令來驗(yàn)證Docker是否安裝成功并啟動Docker服務(wù)# 啟動Docker服務(wù)并設(shè)置開機(jī)自啟 sudo systemctl start docker sudo systemctl enable docker # 驗(yàn)證安裝運(yùn)行hello-world鏡像 sudo docker run hello-world如果看到“Hello from Docker!”等歡迎信息說明Docker已經(jīng)安裝并運(yùn)行正常。為了后續(xù)操作方便避免每次都使用sudo可以將當(dāng)前用戶加入docker用戶組sudo usermod -aG docker $USER執(zhí)行此命令后你需要完全退出當(dāng)前終端會話并重新登錄或者新開一個終端窗口用戶組變更才會生效。注意在生產(chǎn)環(huán)境中將用戶加入docker組意味著該用戶擁有了等同于root的權(quán)限因?yàn)槿萜骺梢話燧d主機(jī)目錄、操作網(wǎng)絡(luò)等。在個人開發(fā)或測試環(huán)境這樣做很方便但在多用戶或生產(chǎn)服務(wù)器上需要仔細(xì)評估權(quán)限管理的策略。2.2 Docker核心概念與本次搭建的架構(gòu)設(shè)計(jì)在動手之前快速理解幾個核心概念這對理解我們后續(xù)的每一步操作至關(guān)重要鏡像Image一個只讀的模板包含了運(yùn)行應(yīng)用所需的代碼、運(yùn)行時、庫、環(huán)境變量和配置文件。例如nginx:latest、mysql:8.0都是鏡像。我們后續(xù)的操作就是基于這些鏡像來創(chuàng)建容器。容器Container鏡像的運(yùn)行實(shí)例。你可以把它理解為一個輕量級的、隔離的虛擬機(jī)進(jìn)程。我們將會運(yùn)行Nginx容器、MySQL容器和PHP-FPM容器。Dockerfile一個文本文件包含了一系列指令用于構(gòu)建一個自定義的鏡像。雖然本次我們主要使用官方鏡像但理解它有助于后續(xù)定制。Docker Compose一個用于定義和運(yùn)行多容器Docker應(yīng)用的工具。通過一個docker-compose.yml文件我們可以配置整個LNMP服務(wù)棧Nginx, MySQL, PHP以及它們之間的關(guān)系然后用一條命令啟動所有服務(wù)。這是管理多容器項(xiàng)目的最佳實(shí)踐我們將在核心環(huán)節(jié)使用它。本次LNMP Docker架構(gòu)設(shè)計(jì)我們將采用“每個服務(wù)一個容器”的最佳實(shí)踐MySQL容器運(yùn)行MySQL數(shù)據(jù)庫服務(wù)并創(chuàng)建一個數(shù)據(jù)卷Volume用于持久化存儲數(shù)據(jù)庫文件這樣即使容器刪除數(shù)據(jù)也不會丟失。PHP-FPM容器運(yùn)行PHP-FPMFastCGI進(jìn)程管理器服務(wù)負(fù)責(zé)處理PHP腳本。我們的項(xiàng)目代碼將通過一個綁定掛載Bind Mount的方式放入此容器實(shí)現(xiàn)代碼實(shí)時同步。Nginx容器運(yùn)行Nginx Web服務(wù)器。它通過Docker網(wǎng)絡(luò)與PHP-FPM容器通信將.php請求轉(zhuǎn)發(fā)給PHP-FPM處理并通過綁定掛載共享項(xiàng)目代碼目錄用于讀取靜態(tài)文件和Nginx配置文件。三個容器通過Docker Compose定義的網(wǎng)絡(luò)連接在一起形成一個內(nèi)部私有的網(wǎng)絡(luò)它們可以通過容器名稱相互訪問。項(xiàng)目代碼和配置文件存放在宿主機(jī)上便于我們直接編輯。3. 核心環(huán)節(jié)使用Docker Compose編排LNMP手動用docker run命令一個個啟動容器并配置網(wǎng)絡(luò)和數(shù)據(jù)卷是可行的但非常繁瑣且不易管理。Docker Compose是解決這個問題的標(biāo)準(zhǔn)答案。我們將創(chuàng)建一個docker-compose.yml文件來定義整個服務(wù)棧。首先為我們的項(xiàng)目創(chuàng)建一個工作目錄并進(jìn)入該目錄mkdir -p ~/projects/docker-lnmp cd ~/projects/docker-lnmp然后創(chuàng)建并編輯docker-compose.yml文件vim docker-compose.yml將以下內(nèi)容寫入文件。我會逐段解釋關(guān)鍵配置version: 3.8 services: # MySQL 數(shù)據(jù)庫服務(wù) mysql: image: mysql:8.0 container_name: lnmp-mysql restart: unless-stopped environment: MYSQL_ROOT_PASSWORD: your_strong_root_password # 務(wù)必修改為強(qiáng)密碼 MYSQL_DATABASE: myapp_db # 容器啟動時自動創(chuàng)建的數(shù)據(jù)庫 MYSQL_USER: myapp_user # 自動創(chuàng)建的用戶 MYSQL_PASSWORD: your_user_password # 對應(yīng)用戶的密碼 volumes: - mysql_data:/var/lib/mysql # 使用命名卷持久化數(shù)據(jù)庫數(shù)據(jù) - ./mysql/init.sql:/docker-entrypoint-initdb.d/init.sql # 可選初始SQL腳本 networks: - lnmp-network ports: - 3306:3306 # 將宿主機(jī)的3306端口映射到容器的3306端口方便宿主機(jī)工具連接 # PHP-FPM 應(yīng)用服務(wù) php-fpm: image: php:8.2-fpm # 使用PHP 8.2的FPM版本 container_name: lnmp-php-fpm restart: unless-stopped working_dir: /var/www/html # 容器內(nèi)的工作目錄 volumes: - ./src:/var/www/html # 關(guān)鍵將宿主機(jī)項(xiàng)目代碼目錄掛載到容器內(nèi) - ./php/php.ini:/usr/local/etc/php/conf.d/custom.ini # 自定義PHP配置 depends_on: - mysql # 確保mysql服務(wù)先啟動 networks: - lnmp-network # Nginx Web服務(wù)器 nginx: image: nginx:alpine # 使用輕量級的Alpine版本 container_name: lnmp-nginx restart: unless-stopped ports: - 80:80 # 將宿主機(jī)80端口映射到容器80端口 - 443:443 # 如果需要HTTPS映射443端口 volumes: - ./src:/var/www/html # 與php-fpm容器掛載相同的代碼目錄 - ./nginx/conf.d:/etc/nginx/conf.d # 掛載自定義的Nginx站點(diǎn)配置 - ./nginx/logs:/var/log/nginx # 掛載日志目錄方便查看 depends_on: - php-fpm networks: - lnmp-network # 定義數(shù)據(jù)卷用于持久化MySQL數(shù)據(jù) volumes: mysql_data: driver: local # 定義自定義網(wǎng)絡(luò)讓三個服務(wù)在同一個網(wǎng)絡(luò)內(nèi)互通 networks: lnmp-network: driver: bridge關(guān)鍵配置解析與注意事項(xiàng)版本與環(huán)境變量version: 3.8指定了Compose文件的語法版本。在mysql服務(wù)中我們通過environment設(shè)置了root密碼、初始數(shù)據(jù)庫和用戶。這是安全的重災(zāi)區(qū)your_strong_root_password和your_user_password必須替換為你自己的、足夠復(fù)雜的密碼。切勿使用簡單密碼或提交到代碼倉庫。數(shù)據(jù)持久化Volumesmysql_data:/var/lib/mysql這是一個命名卷Named Volume。Docker會管理這個卷的存儲位置即使lnmp-mysql容器被刪除這個卷及其中的數(shù)據(jù)依然存在。下次啟動新容器時掛載它數(shù)據(jù)就恢復(fù)了。這是持久化數(shù)據(jù)庫數(shù)據(jù)的標(biāo)準(zhǔn)做法。./src:/var/www/html這是一個綁定掛載Bind Mount。它將宿主機(jī)的./src目錄相對路徑直接掛載到容器內(nèi)的/var/www/html。這樣我們在宿主機(jī)上編輯PHP代碼容器內(nèi)立即生效無需重建鏡像極大方便了開發(fā)。./nginx/conf.d:/etc/nginx/conf.d同樣使用綁定掛載讓我們可以自定義Nginx的站點(diǎn)配置文件而無需進(jìn)入容器內(nèi)部修改。網(wǎng)絡(luò)Networks我們創(chuàng)建了一個名為lnmp-network的自定義橋接網(wǎng)絡(luò)。三個服務(wù)都加入了這個網(wǎng)絡(luò)。在這個網(wǎng)絡(luò)內(nèi)部容器之間可以使用服務(wù)名service name作為主機(jī)名進(jìn)行通信。例如在php-fpm容器中你可以直接使用mysql這個主機(jī)名連接到MySQL數(shù)據(jù)庫連接地址就是mysql:3306這比使用動態(tài)分配的IP地址穩(wěn)定得多。依賴與啟動順序depends_on指令確保了服務(wù)的啟動順序。php-fpm依賴于mysqlnginx依賴于php-fpm。這意味著Docker Compose會先啟動mysql然后是php-fpm最后是nginx。但這僅代表容器啟動順序并不保證容器內(nèi)的服務(wù)如MySQL已經(jīng)完全初始化并準(zhǔn)備好接受連接。對于需要等待數(shù)據(jù)庫就緒的應(yīng)用需要在應(yīng)用層如PHP腳本或使用更高級的工具如wait-for-it腳本處理。4. 配置詳解與項(xiàng)目部署實(shí)戰(zhàn)配置文件是靈魂?，F(xiàn)在我們來創(chuàng)建docker-compose.yml中引用的各個目錄和配置文件。4.1 創(chuàng)建項(xiàng)目目錄結(jié)構(gòu)在docker-lnmp目錄下執(zhí)行以下命令創(chuàng)建所需的目錄mkdir -p src nginx/conf.d nginx/logs php mysql創(chuàng)建后的目錄樹如下docker-lnmp/ ├── docker-compose.yml ├── src/ # 項(xiàng)目PHP代碼存放處 ├── nginx/ │ ├── conf.d/ # Nginx站點(diǎn)配置文件 │ └── logs/ # Nginx日志目錄 ├── php/ # PHP自定義配置 └── mysql/ # MySQL初始化腳本可選4.2 配置Nginx連接PHP-FPMNginx需要知道如何將PHP請求轉(zhuǎn)發(fā)給PHP-FPM容器。我們在nginx/conf.d/目錄下創(chuàng)建一個名為default.conf的配置文件vim nginx/conf.d/default.conf寫入以下配置server { listen 80; server_name localhost; # 或你的域名 root /var/www/html; index index.php index.html index.htm; access_log /var/log/nginx/access.log; error_log /var/log/nginx/error.log; location / { try_files $uri $uri/ /index.php?$query_string; } # 關(guān)鍵配置將所有.php請求轉(zhuǎn)發(fā)給php-fpm容器處理 location ~ \.php$ { fastcgi_pass php-fpm:9000; # 使用服務(wù)名“php-fpm”端口9000 fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } # 禁止訪問.htaccess等隱藏文件 location ~ /\.ht { deny all; } }配置核心解析fastcgi_pass php-fpm:9000;這是整個配置的靈魂。它告訴Nginx對于PHP請求應(yīng)該轉(zhuǎn)發(fā)到名為php-fpm的主機(jī)的9000端口。注意這里用的是我們在docker-compose.yml中定義的服務(wù)名php-fpm而不是IP地址。Docker的網(wǎng)絡(luò)DNS解析會自動將服務(wù)名映射到對應(yīng)容器的IP。fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;這個參數(shù)至關(guān)重要它告訴PHP-FPM要執(zhí)行的文件路徑。$document_root對應(yīng)Nginx的root目錄/var/www/html$fastcgi_script_name是請求的PHP文件名。兩者拼接起來就是PHP文件在容器內(nèi)的絕對路徑。try_files $uri $uri/ /index.php?$query_string;這是一個常見的重寫規(guī)則用于實(shí)現(xiàn)“前端控制器”模式如Laravel等框架將非靜態(tài)文件請求都引導(dǎo)到index.php處理。4.3 配置PHP連接MySQL我們可能需要調(diào)整一些PHP設(shè)置比如時區(qū)、上傳文件大小等。在php/目錄下創(chuàng)建自定義配置文件vim php/php.ini寫入一些常用配置; 設(shè)置時區(qū) date.timezone Asia/Shanghai ; 調(diào)整內(nèi)存限制和上傳文件大小根據(jù)項(xiàng)目需要 memory_limit 256M upload_max_filesize 64M post_max_size 64M ; 開啟錯誤日志開發(fā)環(huán)境建議開啟生產(chǎn)環(huán)境關(guān)閉 display_errors On log_errors On error_log /var/log/php_errors.log這個文件會被掛載到PHP容器的/usr/local/etc/php/conf.d/custom.ini覆蓋或追加默認(rèn)的PHP配置。4.4 編寫測試項(xiàng)目并連接數(shù)據(jù)庫現(xiàn)在我們在src/目錄下創(chuàng)建一個最簡單的PHP項(xiàng)目來測試整個環(huán)境。首先創(chuàng)建信息探針文件src/info.php?php phpinfo();然后創(chuàng)建一個連接數(shù)據(jù)庫的測試文件src/db_test.php?php header(Content-Type: text/html; charsetutf-8); // 使用Docker Compose中定義的服務(wù)名和端口連接MySQL $host mysql; // 對應(yīng) docker-compose.yml 中的服務(wù)名 $dbname myapp_db; // 對應(yīng)我們環(huán)境變量中創(chuàng)建的數(shù)據(jù)庫 $username myapp_user; $password your_user_password; // 替換為你在docker-compose.yml中設(shè)置的密碼 try { $pdo new PDO(mysql:host$host;dbname$dbname;charsetutf8mb4, $username, $password); $pdo-setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); echo h2數(shù)據(jù)庫連接成功/h2; // 嘗試執(zhí)行一個簡單查詢 $stmt $pdo-query(SELECT VERSION() as version); $result $stmt-fetch(PDO::FETCH_ASSOC); echo MySQL服務(wù)器版本: . $result[version] . br; // 創(chuàng)建一個測試表并插入數(shù)據(jù) $pdo-exec(CREATE TABLE IF NOT EXISTS test_users ( id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(100) NOT NULL, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP )); $pdo-exec(INSERT INTO test_users (name) VALUES (Docker LNMP Test User)); echo 測試數(shù)據(jù)插入成功br; // 查詢并顯示數(shù)據(jù) $stmt $pdo-query(SELECT * FROM test_users); echo h3測試用戶列表/h3; echo ul; while ($row $stmt-fetch(PDO::FETCH_ASSOC)) { echo liID: {$row[id]}, Name: {$row[name]}, Created: {$row[created_at]}/li; } echo /ul; } catch (PDOException $e) { die(h2數(shù)據(jù)庫連接失敗/h2 . $e-getMessage()); } ?關(guān)鍵點(diǎn)說明連接主機(jī)名$host mysql;這正是我們在docker-compose.yml中定義的MySQL服務(wù)名。Docker網(wǎng)絡(luò)使得容器間可以通過服務(wù)名直接通信。數(shù)據(jù)庫名、用戶名和密碼需要與docker-compose.yml中environment部分設(shè)置的環(huán)境變量一致。4.5 啟動LNMP服務(wù)棧所有配置和代碼準(zhǔn)備就緒現(xiàn)在可以啟動我們的Docker LNMP環(huán)境了。在docker-lnmp目錄下運(yùn)行docker-compose up -d-d參數(shù)代表“detached”模式讓服務(wù)在后臺運(yùn)行。你會看到Docker開始拉取鏡像如果本地沒有然后創(chuàng)建網(wǎng)絡(luò)、卷并依次啟動三個容器。使用以下命令查看容器狀態(tài)docker-compose ps如果一切正常你應(yīng)該看到三個服務(wù)的狀態(tài)都是“Up”。你也可以用docker logs lnmp-nginx等命令查看特定容器的日志。4.6 測試與訪問打開你的瀏覽器訪問以下地址測試Nginx與PHP訪問http://你的服務(wù)器IP或localhost/info.php。你應(yīng)該能看到標(biāo)準(zhǔn)的PHP信息頁面其中“Server API”一項(xiàng)應(yīng)該顯示為“FPM/FastCGI”。這證明Nginx和PHP-FPM協(xié)同工作正常。測試數(shù)據(jù)庫連接訪問http://你的服務(wù)器IP或localhost/db_test.php。如果配置正確頁面會顯示“數(shù)據(jù)庫連接成功”、MySQL版本號以及插入的測試數(shù)據(jù)。這證明PHP容器能夠通過Docker網(wǎng)絡(luò)成功連接到MySQL容器。至此一個基于Docker的完整LNMP開發(fā)/測試環(huán)境就已經(jīng)搭建并運(yùn)行成功了。你的項(xiàng)目PHP代碼只需放在宿主機(jī)的src/目錄下就能立即生效。5. 進(jìn)階配置、管理與問題排查基礎(chǔ)環(huán)境跑起來只是第一步要讓這個環(huán)境更健壯、更適合生產(chǎn)或團(tuán)隊(duì)協(xié)作還需要考慮更多細(xì)節(jié)。5.1 使用自定義Dockerfile構(gòu)建PHP鏡像官方php:8.2-fpm鏡像很純凈但我們的項(xiàng)目通常需要安裝額外的PHP擴(kuò)展如pdo_mysql,gd,redis等。我們可以通過自定義Dockerfile來構(gòu)建一個包含所需擴(kuò)展的PHP鏡像。在項(xiàng)目根目錄創(chuàng)建Dockerfile# 使用官方PHP-FPM鏡像作為基礎(chǔ) FROM php:8.2-fpm # 安裝系統(tǒng)依賴和PHP擴(kuò)展 RUN apt-get update apt-get install -y \ libpng-dev \ libjpeg-dev \ libfreetype6-dev \ libzip-dev \ zip \ unzip \ git \ curl \ docker-php-ext-configure gd --with-freetype --with-jpeg \ docker-php-ext-install -j$(nproc) \ pdo_mysql \ mysqli \ gd \ zip \ opcache \ apt-get clean rm -rf /var/lib/apt/lists/* # 安裝ComposerPHP包管理工具 COPY --fromcomposer:latest /usr/bin/composer /usr/bin/composer # 設(shè)置工作目錄 WORKDIR /var/www/html然后修改docker-compose.yml中的php-fpm服務(wù)不再使用image而是使用build上下文來構(gòu)建鏡像php-fpm: build: . # 使用當(dāng)前目錄下的Dockerfile構(gòu)建 container_name: lnmp-php-fpm restart: unless-stopped # ... 其余配置保持不變之后運(yùn)行docker-compose up -d --buildCompose會重新構(gòu)建PHP鏡像并啟動服務(wù)。5.2 數(shù)據(jù)備份與遷移由于數(shù)據(jù)庫數(shù)據(jù)持久化在名為mysql_data的Docker卷中備份和遷移變得非常清晰。備份你可以使用docker run命令啟動一個臨時MySQL容器連接到這個數(shù)據(jù)卷并執(zhí)行mysqldump。docker run --rm -v mysql_data:/volume -v $(pwd):/backup alpine \ sh -c apk add --no-cache mysql-client mysqldump -h mysql -u myapp_user -pyour_user_password myapp_db /backup/backup_$(date %Y%m%d_%H%M%S).sql更簡單的方式是直接進(jìn)入MySQL容器執(zhí)行備份docker exec lnmp-mysql mysqldump -u myapp_user -pyour_user_password myapp_db backup.sql遷移將整個項(xiàng)目遷移到新服務(wù)器只需要三步將項(xiàng)目目錄docker-compose.yml,src/,nginx/,php/等拷貝到新服務(wù)器。在新服務(wù)器安裝Docker和Docker Compose。在新服務(wù)器項(xiàng)目目錄下運(yùn)行docker-compose up -d。MySQL容器會自動創(chuàng)建新的空數(shù)據(jù)卷。如果需要恢復(fù)數(shù)據(jù)可以將備份的SQL文件放到mysql/目錄下并在docker-compose.yml中配置掛載如我們之前注釋掉的init.sql掛載或者啟動后手動導(dǎo)入。5.3 常見問題與排查技巧實(shí)錄在實(shí)際操作中你可能會遇到一些問題。這里記錄一些常見坑點(diǎn)和排查思路。問題1訪問info.php顯示“File not found.” 或 空白頁。排查思路檢查文件路徑首先進(jìn)入Nginx容器確認(rèn)文件是否存在。docker exec -it lnmp-nginx sh ls -la /var/www/html/info.php如果不存在說明宿主機(jī)src/目錄到容器的掛載可能失敗了。檢查docker-compose.yml中Nginx和PHP-FPM服務(wù)的volumes配置路徑是否正確。檢查Nginx配置確認(rèn)fastcgi_param SCRIPT_FILENAME設(shè)置正確。確保$document_root指向了正確的目錄/var/www/html。檢查PHP-FPM容器進(jìn)入PHP-FPM容器查看PHP錯誤日志。docker exec -it lnmp-php-fpm bash tail -f /var/log/php_errors.log # 如果配置了的話或者查看Docker容器日志docker logs lnmp-php-fpm檢查網(wǎng)絡(luò)連通性在Nginx容器內(nèi)嘗試ping PHP-FPM服務(wù)。docker exec lnmp-nginx ping php-fpm如果ping不通檢查docker-compose.yml中的networks配置確保所有服務(wù)都在同一個自定義網(wǎng)絡(luò)下。問題2訪問db_test.php顯示數(shù)據(jù)庫連接失敗如“SQLSTATE[HY000] [2002] Connection refused”。排查思路確認(rèn)MySQL容器是否運(yùn)行正常docker-compose ps查看狀態(tài)docker logs lnmp-mysql查看啟動日志確認(rèn)沒有初始化錯誤。檢查連接參數(shù)確認(rèn)db_test.php中使用的host是服務(wù)名mysql端口是3306默認(rèn)數(shù)據(jù)庫名、用戶名、密碼與docker-compose.yml中的environment完全一致。特別注意密碼中的特殊字符可能需要轉(zhuǎn)義。從PHP容器內(nèi)部測試連接進(jìn)入PHP-FPM容器安裝MySQL客戶端并嘗試連接。docker exec -it lnmp-php-fpm bash apt update apt install -y mysql-client # 如果鏡像內(nèi)沒有的話 mysql -h mysql -u myapp_user -p輸入密碼看是否能連接成功。這能直接判斷網(wǎng)絡(luò)和認(rèn)證是否有問題。檢查MySQL用戶權(quán)限有時需要確認(rèn)創(chuàng)建的用戶是否有從任意主機(jī)%連接的權(quán)限。可以在MySQL容器內(nèi)登錄root賬戶進(jìn)行授權(quán)生產(chǎn)環(huán)境需謹(jǐn)慎docker exec -it lnmp-mysql mysql -uroot -p # 輸入root密碼后 GRANT ALL PRIVILEGES ON myapp_db.* TO myapp_user%; FLUSH PRIVILEGES;問題3修改了Nginx或PHP配置后不生效。排查思路重啟服務(wù)修改宿主機(jī)上的配置文件后需要讓容器內(nèi)的服務(wù)重新加載配置。對于Nginxdocker exec lnmp-nginx nginx -s reload對于PHP-FPMdocker exec lnmp-php-fpm kill -USR2 1(發(fā)送信號給主進(jìn)程) 或直接重啟容器docker-compose restart php-fpm檢查配置文件語法Nginx:docker exec lnmp-nginx nginx -tPHP: 重啟時查看容器日志docker logs lnmp-php-fpm看是否有配置解析錯誤。確認(rèn)掛載成功進(jìn)入容器查看配置文件內(nèi)容是否與宿主機(jī)一致。問題4Docker Compose up 時提示端口被占用。排查思路docker-compose.yml中ports映射將宿主機(jī)端口如803306映射到容器。如果宿主機(jī)上已有服務(wù)如本機(jī)ApacheMySQL占用了這些端口就會沖突。解決方案1停止宿主機(jī)上的沖突服務(wù)。解決方案2修改docker-compose.yml中的端口映射例如將80:80改為8080:80這樣通過宿主機(jī)的8080端口訪問容器內(nèi)的80服務(wù)。一個實(shí)用的調(diào)試技巧使用docker-compose logs當(dāng)服務(wù)出現(xiàn)問題時第一時間的日志是最重要的線索。使用以下命令可以查看所有服務(wù)的實(shí)時日志或者查看特定服務(wù)的日志# 查看所有服務(wù)的日志尾部 docker-compose logs # 查看特定服務(wù)如nginx的日志并實(shí)時刷新 docker-compose logs -f nginx # 查看從啟動開始的所有日志 docker-compose logs --tailall6. 生產(chǎn)環(huán)境考量與優(yōu)化建議上面搭建的環(huán)境非常適合本地開發(fā)和測試。但如果要用于生產(chǎn)環(huán)境還需要在安全、性能和監(jiān)控方面做更多工作。6.1 安全加固使用非root用戶運(yùn)行容器默認(rèn)情況下容器內(nèi)的進(jìn)程以root運(yùn)行。可以在Dockerfile中使用USER指令或者在docker-compose.yml中使用user選項(xiàng)指定一個非root用戶來運(yùn)行進(jìn)程。services: php-fpm: image: php:8.2-fpm user: 1000:1000 # 使用宿主機(jī)某個普通用戶的UID和GID # ...限制容器資源在docker-compose.yml中為每個服務(wù)設(shè)置CPU和內(nèi)存限制防止單個容器耗盡主機(jī)資源。services: mysql: # ... deploy: resources: limits: cpus: 1.0 memory: 1G reservations: cpus: 0.5 memory: 512M使用Secret管理敏感信息將數(shù)據(jù)庫密碼等敏感信息直接寫在docker-compose.yml中是不安全的。Docker Swarm或Kubernetes提供了Secrets管理對于單機(jī)Docker可以考慮使用環(huán)境變量文件.env并確保該文件不被提交到版本控制系統(tǒng)。創(chuàng)建.env文件MYSQL_ROOT_PASSWORDyour_very_strong_password_here MYSQL_PASSWORDanother_strong_password在docker-compose.yml中引用environment: MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}僅暴露必要端口生產(chǎn)環(huán)境中MySQL的3306端口不應(yīng)映射到宿主機(jī)公網(wǎng)IP?？梢砸瞥齪orts中的3306:3306僅讓MySQL在Docker內(nèi)部網(wǎng)絡(luò)中被訪問。Web服務(wù)Nginx的80/443端口需要暴露。6.2 性能與可用性為PHP配置OPcacheOPcache可以極大提升PHP性能。確保在php.ini或自定義配置中啟用并優(yōu)化OPcache設(shè)置。Nginx緩存與優(yōu)化根據(jù)項(xiàng)目類型配置Nginx的靜態(tài)文件緩存、代理緩存等。使用更高效的存儲驅(qū)動對于Linuxoverlay2是推薦的存儲驅(qū)動?？梢酝ㄟ^docker info查看。考慮使用Docker Swarm或Kubernetes對于需要高可用的生產(chǎn)環(huán)境單機(jī)Docker Compose不夠。應(yīng)該使用Docker Swarm或Kubernetes來編排容器實(shí)現(xiàn)服務(wù)發(fā)現(xiàn)、負(fù)載均衡、滾動更新和自愈。6.3 監(jiān)控與日志集中式日志將Docker容器的日志收集到ELKElasticsearch, Logstash, Kibana或LokiGrafana等日志系統(tǒng)中便于統(tǒng)一查詢和分析。容器監(jiān)控使用cAdvisor、Prometheus和Grafana監(jiān)控容器的資源使用情況CPU、內(nèi)存、網(wǎng)絡(luò)、磁盤IO。應(yīng)用性能監(jiān)控APM集成如New Relic、Datadog或開源的Pinpoint、SkyWalking等工具監(jiān)控PHP應(yīng)用內(nèi)部的性能瓶頸。從手動安裝配置到使用Docker Compose一鍵編排LNMP環(huán)境的搭建和維護(hù)方式發(fā)生了根本性的變化。容器化帶來的隔離性、一致性和可移植性使得開發(fā)、測試和生產(chǎn)環(huán)境的高度統(tǒng)一成為可能也極大地簡化了運(yùn)維復(fù)雜度。雖然初始的配置需要一些學(xué)習(xí)成本但一旦掌握它所帶來的效率提升和問題減少是巨大的。希望這篇詳細(xì)的指南能幫助你順利踏上Docker化部署之路。 Docker LNMP環(huán)境搭建：容器化部署PHP項(xiàng)目的完整實(shí)踐指南
1. 項(xiàng)目概述為什么選擇Docker來搭建LNMP如果你是一名后端開發(fā)者、運(yùn)維工程師或者正在學(xué)習(xí)Web開發(fā)那么“LNMP”這個組合對你來說一定不陌生。它代表了Linux、Nginx、MySQL和PHP是構(gòu)建動態(tài)網(wǎng)站最經(jīng)典、最穩(wěn)定的技術(shù)棧之一。傳統(tǒng)的LNMP環(huán)境搭建通常意味著我們需要在服務(wù)器上手動安裝和配置這四大組件處理各種依賴、版本沖突和權(quán)限問題過程繁瑣且容易出錯一旦系統(tǒng)環(huán)境變化遷移和復(fù)現(xiàn)更是頭疼。這正是Docker大顯身手的地方。Docker通過容器化技術(shù)將應(yīng)用及其所有依賴打包在一個獨(dú)立的、可移植的“容器”中。對于LNMP環(huán)境搭建來說這意味著我們可以將Nginx、MySQL、PHP分別封裝在獨(dú)立的容器里它們彼此隔離互不干擾。你需要哪個版本的PHP7.4還是8.2直接拉取對應(yīng)的鏡像即可。想在同一臺服務(wù)器上運(yùn)行多個不同配置的項(xiàng)目容器間的網(wǎng)絡(luò)和存儲可以輕松隔離和管理。所以今天我要分享的就是如何在Linux系統(tǒng)下使用Docker從零開始搭建一個完整的LNMP環(huán)境并部署一個實(shí)際的PHP項(xiàng)目。整個過程我會拆解得非常細(xì)致從Docker的基本操作講起到每個服務(wù)的容器化配置、容器間的網(wǎng)絡(luò)通信、數(shù)據(jù)持久化最后完成項(xiàng)目的部署和訪問。無論你是Docker新手還是有一定經(jīng)驗(yàn)想尋求更佳實(shí)踐這篇內(nèi)容都能給你提供一條清晰的路徑和許多實(shí)操中積累下來的細(xì)節(jié)技巧。2. 環(huán)境準(zhǔn)備與Docker基礎(chǔ)在開始搭建之前我們需要一個干凈的Linux環(huán)境。我使用的是Ubuntu 22.04 LTS但CentOS、Debian等主流發(fā)行版的步驟也大同小異。核心是確保Docker能夠正確安裝和運(yùn)行。2.1 Docker安裝與驗(yàn)證首先我們需要安裝Docker Engine。這里我推薦使用官方提供的安裝腳本它比通過系統(tǒng)包管理器安裝通常能獲得更新的版本。打開終端執(zhí)行以下命令來安裝Docker# 1. 卸載舊版本如果存在 sudo apt-get remove docker docker-engine docker.io containerd runc # 2. 更新apt包索引并安裝依賴 sudo apt-get update sudo apt-get install -y ca-certificates curl gnupg lsb-release # 3. 添加Docker官方GPG密鑰 sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg # 4. 設(shè)置穩(wěn)定版?zhèn)}庫 echo \ deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null # 5. 安裝Docker Engine sudo apt-get update sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin安裝完成后運(yùn)行下面的命令來驗(yàn)證Docker是否安裝成功并啟動Docker服務(wù)# 啟動Docker服務(wù)并設(shè)置開機(jī)自啟 sudo systemctl start docker sudo systemctl enable docker # 驗(yàn)證安裝運(yùn)行hello-world鏡像 sudo docker run hello-world如果看到“Hello from Docker!”等歡迎信息說明Docker已經(jīng)安裝并運(yùn)行正常。為了后續(xù)操作方便避免每次都使用sudo可以將當(dāng)前用戶加入docker用戶組sudo usermod -aG docker $USER執(zhí)行此命令后你需要完全退出當(dāng)前終端會話并重新登錄或者新開一個終端窗口用戶組變更才會生效。注意在生產(chǎn)環(huán)境中將用戶加入docker組意味著該用戶擁有了等同于root的權(quán)限因?yàn)槿萜骺梢話燧d主機(jī)目錄、操作網(wǎng)絡(luò)等。在個人開發(fā)或測試環(huán)境這樣做很方便但在多用戶或生產(chǎn)服務(wù)器上需要仔細(xì)評估權(quán)限管理的策略。2.2 Docker核心概念與本次搭建的架構(gòu)設(shè)計(jì)在動手之前快速理解幾個核心概念這對理解我們后續(xù)的每一步操作至關(guān)重要鏡像Image一個只讀的模板包含了運(yùn)行應(yīng)用所需的代碼、運(yùn)行時、庫、環(huán)境變量和配置文件。例如nginx:latest、mysql:8.0都是鏡像。我們后續(xù)的操作就是基于這些鏡像來創(chuàng)建容器。容器Container鏡像的運(yùn)行實(shí)例。你可以把它理解為一個輕量級的、隔離的虛擬機(jī)進(jìn)程。我們將會運(yùn)行Nginx容器、MySQL容器和PHP-FPM容器。Dockerfile一個文本文件包含了一系列指令用于構(gòu)建一個自定義的鏡像。雖然本次我們主要使用官方鏡像但理解它有助于后續(xù)定制。Docker Compose一個用于定義和運(yùn)行多容器Docker應(yīng)用的工具。通過一個docker-compose.yml文件我們可以配置整個LNMP服務(wù)棧Nginx, MySQL, PHP以及它們之間的關(guān)系然后用一條命令啟動所有服務(wù)。這是管理多容器項(xiàng)目的最佳實(shí)踐我們將在核心環(huán)節(jié)使用它。本次LNMP Docker架構(gòu)設(shè)計(jì)我們將采用“每個服務(wù)一個容器”的最佳實(shí)踐MySQL容器運(yùn)行MySQL數(shù)據(jù)庫服務(wù)并創(chuàng)建一個數(shù)據(jù)卷Volume用于持久化存儲數(shù)據(jù)庫文件這樣即使容器刪除數(shù)據(jù)也不會丟失。PHP-FPM容器運(yùn)行PHP-FPMFastCGI進(jìn)程管理器服務(wù)負(fù)責(zé)處理PHP腳本。我們的項(xiàng)目代碼將通過一個綁定掛載Bind Mount的方式放入此容器實(shí)現(xiàn)代碼實(shí)時同步。Nginx容器運(yùn)行Nginx Web服務(wù)器。它通過Docker網(wǎng)絡(luò)與PHP-FPM容器通信將.php請求轉(zhuǎn)發(fā)給PHP-FPM處理并通過綁定掛載共享項(xiàng)目代碼目錄用于讀取靜態(tài)文件和Nginx配置文件。三個容器通過Docker Compose定義的網(wǎng)絡(luò)連接在一起形成一個內(nèi)部私有的網(wǎng)絡(luò)它們可以通過容器名稱相互訪問。項(xiàng)目代碼和配置文件存放在宿主機(jī)上便于我們直接編輯。3. 核心環(huán)節(jié)使用Docker Compose編排LNMP手動用docker run命令一個個啟動容器并配置網(wǎng)絡(luò)和數(shù)據(jù)卷是可行的但非常繁瑣且不易管理。Docker Compose是解決這個問題的標(biāo)準(zhǔn)答案。我們將創(chuàng)建一個docker-compose.yml文件來定義整個服務(wù)棧。首先為我們的項(xiàng)目創(chuàng)建一個工作目錄并進(jìn)入該目錄mkdir -p ~/projects/docker-lnmp cd ~/projects/docker-lnmp然后創(chuàng)建并編輯docker-compose.yml文件vim docker-compose.yml將以下內(nèi)容寫入文件。我會逐段解釋關(guān)鍵配置version: 3.8 services: # MySQL 數(shù)據(jù)庫服務(wù) mysql: image: mysql:8.0 container_name: lnmp-mysql restart: unless-stopped environment: MYSQL_ROOT_PASSWORD: your_strong_root_password # 務(wù)必修改為強(qiáng)密碼 MYSQL_DATABASE: myapp_db # 容器啟動時自動創(chuàng)建的數(shù)據(jù)庫 MYSQL_USER: myapp_user # 自動創(chuàng)建的用戶 MYSQL_PASSWORD: your_user_password # 對應(yīng)用戶的密碼 volumes: - mysql_data:/var/lib/mysql # 使用命名卷持久化數(shù)據(jù)庫數(shù)據(jù) - ./mysql/init.sql:/docker-entrypoint-initdb.d/init.sql # 可選初始SQL腳本 networks: - lnmp-network ports: - 3306:3306 # 將宿主機(jī)的3306端口映射到容器的3306端口方便宿主機(jī)工具連接 # PHP-FPM 應(yīng)用服務(wù) php-fpm: image: php:8.2-fpm # 使用PHP 8.2的FPM版本 container_name: lnmp-php-fpm restart: unless-stopped working_dir: /var/www/html # 容器內(nèi)的工作目錄 volumes: - ./src:/var/www/html # 關(guān)鍵將宿主機(jī)項(xiàng)目代碼目錄掛載到容器內(nèi) - ./php/php.ini:/usr/local/etc/php/conf.d/custom.ini # 自定義PHP配置 depends_on: - mysql # 確保mysql服務(wù)先啟動 networks: - lnmp-network # Nginx Web服務(wù)器 nginx: image: nginx:alpine # 使用輕量級的Alpine版本 container_name: lnmp-nginx restart: unless-stopped ports: - 80:80 # 將宿主機(jī)80端口映射到容器80端口 - 443:443 # 如果需要HTTPS映射443端口 volumes: - ./src:/var/www/html # 與php-fpm容器掛載相同的代碼目錄 - ./nginx/conf.d:/etc/nginx/conf.d # 掛載自定義的Nginx站點(diǎn)配置 - ./nginx/logs:/var/log/nginx # 掛載日志目錄方便查看 depends_on: - php-fpm networks: - lnmp-network # 定義數(shù)據(jù)卷用于持久化MySQL數(shù)據(jù) volumes: mysql_data: driver: local # 定義自定義網(wǎng)絡(luò)讓三個服務(wù)在同一個網(wǎng)絡(luò)內(nèi)互通 networks: lnmp-network: driver: bridge關(guān)鍵配置解析與注意事項(xiàng)版本與環(huán)境變量version: 3.8指定了Compose文件的語法版本。在mysql服務(wù)中我們通過environment設(shè)置了root密碼、初始數(shù)據(jù)庫和用戶。這是安全的重災(zāi)區(qū)your_strong_root_password和your_user_password必須替換為你自己的、足夠復(fù)雜的密碼。切勿使用簡單密碼或提交到代碼倉庫。數(shù)據(jù)持久化Volumesmysql_data:/var/lib/mysql這是一個命名卷Named Volume。Docker會管理這個卷的存儲位置即使lnmp-mysql容器被刪除這個卷及其中的數(shù)據(jù)依然存在。下次啟動新容器時掛載它數(shù)據(jù)就恢復(fù)了。這是持久化數(shù)據(jù)庫數(shù)據(jù)的標(biāo)準(zhǔn)做法。./src:/var/www/html這是一個綁定掛載Bind Mount。它將宿主機(jī)的./src目錄相對路徑直接掛載到容器內(nèi)的/var/www/html。這樣我們在宿主機(jī)上編輯PHP代碼容器內(nèi)立即生效無需重建鏡像極大方便了開發(fā)。./nginx/conf.d:/etc/nginx/conf.d同樣使用綁定掛載讓我們可以自定義Nginx的站點(diǎn)配置文件而無需進(jìn)入容器內(nèi)部修改。網(wǎng)絡(luò)Networks我們創(chuàng)建了一個名為lnmp-network的自定義橋接網(wǎng)絡(luò)。三個服務(wù)都加入了這個網(wǎng)絡(luò)。在這個網(wǎng)絡(luò)內(nèi)部容器之間可以使用服務(wù)名service name作為主機(jī)名進(jìn)行通信。例如在php-fpm容器中你可以直接使用mysql這個主機(jī)名連接到MySQL數(shù)據(jù)庫連接地址就是mysql:3306這比使用動態(tài)分配的IP地址穩(wěn)定得多。依賴與啟動順序depends_on指令確保了服務(wù)的啟動順序。php-fpm依賴于mysqlnginx依賴于php-fpm。這意味著Docker Compose會先啟動mysql然后是php-fpm最后是nginx。但這僅代表容器啟動順序并不保證容器內(nèi)的服務(wù)如MySQL已經(jīng)完全初始化并準(zhǔn)備好接受連接。對于需要等待數(shù)據(jù)庫就緒的應(yīng)用需要在應(yīng)用層如PHP腳本或使用更高級的工具如wait-for-it腳本處理。4. 配置詳解與項(xiàng)目部署實(shí)戰(zhàn)配置文件是靈魂?，F(xiàn)在我們來創(chuàng)建docker-compose.yml中引用的各個目錄和配置文件。4.1 創(chuàng)建項(xiàng)目目錄結(jié)構(gòu)在docker-lnmp目錄下執(zhí)行以下命令創(chuàng)建所需的目錄mkdir -p src nginx/conf.d nginx/logs php mysql創(chuàng)建后的目錄樹如下docker-lnmp/ ├── docker-compose.yml ├── src/ # 項(xiàng)目PHP代碼存放處 ├── nginx/ │ ├── conf.d/ # Nginx站點(diǎn)配置文件 │ └── logs/ # Nginx日志目錄 ├── php/ # PHP自定義配置 └── mysql/ # MySQL初始化腳本可選4.2 配置Nginx連接PHP-FPMNginx需要知道如何將PHP請求轉(zhuǎn)發(fā)給PHP-FPM容器。我們在nginx/conf.d/目錄下創(chuàng)建一個名為default.conf的配置文件vim nginx/conf.d/default.conf寫入以下配置server { listen 80; server_name localhost; # 或你的域名 root /var/www/html; index index.php index.html index.htm; access_log /var/log/nginx/access.log; error_log /var/log/nginx/error.log; location / { try_files $uri $uri/ /index.php?$query_string; } # 關(guān)鍵配置將所有.php請求轉(zhuǎn)發(fā)給php-fpm容器處理 location ~ \.php$ { fastcgi_pass php-fpm:9000; # 使用服務(wù)名“php-fpm”端口9000 fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } # 禁止訪問.htaccess等隱藏文件 location ~ /\.ht { deny all; } }配置核心解析fastcgi_pass php-fpm:9000;這是整個配置的靈魂。它告訴Nginx對于PHP請求應(yīng)該轉(zhuǎn)發(fā)到名為php-fpm的主機(jī)的9000端口。注意這里用的是我們在docker-compose.yml中定義的服務(wù)名php-fpm而不是IP地址。Docker的網(wǎng)絡(luò)DNS解析會自動將服務(wù)名映射到對應(yīng)容器的IP。fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;這個參數(shù)至關(guān)重要它告訴PHP-FPM要執(zhí)行的文件路徑。$document_root對應(yīng)Nginx的root目錄/var/www/html$fastcgi_script_name是請求的PHP文件名。兩者拼接起來就是PHP文件在容器內(nèi)的絕對路徑。try_files $uri $uri/ /index.php?$query_string;這是一個常見的重寫規(guī)則用于實(shí)現(xiàn)“前端控制器”模式如Laravel等框架將非靜態(tài)文件請求都引導(dǎo)到index.php處理。4.3 配置PHP連接MySQL我們可能需要調(diào)整一些PHP設(shè)置比如時區(qū)、上傳文件大小等。在php/目錄下創(chuàng)建自定義配置文件vim php/php.ini寫入一些常用配置; 設(shè)置時區(qū) date.timezone Asia/Shanghai ; 調(diào)整內(nèi)存限制和上傳文件大小根據(jù)項(xiàng)目需要 memory_limit 256M upload_max_filesize 64M post_max_size 64M ; 開啟錯誤日志開發(fā)環(huán)境建議開啟生產(chǎn)環(huán)境關(guān)閉 display_errors On log_errors On error_log /var/log/php_errors.log這個文件會被掛載到PHP容器的/usr/local/etc/php/conf.d/custom.ini覆蓋或追加默認(rèn)的PHP配置。4.4 編寫測試項(xiàng)目并連接數(shù)據(jù)庫現(xiàn)在我們在src/目錄下創(chuàng)建一個最簡單的PHP項(xiàng)目來測試整個環(huán)境。首先創(chuàng)建信息探針文件src/info.php?php phpinfo();然后創(chuàng)建一個連接數(shù)據(jù)庫的測試文件src/db_test.php?php header(Content-Type: text/html; charsetutf-8); // 使用Docker Compose中定義的服務(wù)名和端口連接MySQL $host mysql; // 對應(yīng) docker-compose.yml 中的服務(wù)名 $dbname myapp_db; // 對應(yīng)我們環(huán)境變量中創(chuàng)建的數(shù)據(jù)庫 $username myapp_user; $password your_user_password; // 替換為你在docker-compose.yml中設(shè)置的密碼 try { $pdo new PDO(mysql:host$host;dbname$dbname;charsetutf8mb4, $username, $password); $pdo-setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); echo h2數(shù)據(jù)庫連接成功/h2; // 嘗試執(zhí)行一個簡單查詢 $stmt $pdo-query(SELECT VERSION() as version); $result $stmt-fetch(PDO::FETCH_ASSOC); echo MySQL服務(wù)器版本: . $result[version] . br; // 創(chuàng)建一個測試表并插入數(shù)據(jù) $pdo-exec(CREATE TABLE IF NOT EXISTS test_users ( id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(100) NOT NULL, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP )); $pdo-exec(INSERT INTO test_users (name) VALUES (Docker LNMP Test User)); echo 測試數(shù)據(jù)插入成功br; // 查詢并顯示數(shù)據(jù) $stmt $pdo-query(SELECT * FROM test_users); echo h3測試用戶列表/h3; echo ul; while ($row $stmt-fetch(PDO::FETCH_ASSOC)) { echo liID: {$row[id]}, Name: {$row[name]}, Created: {$row[created_at]}/li; } echo /ul; } catch (PDOException $e) { die(h2數(shù)據(jù)庫連接失敗/h2 . $e-getMessage()); } ?關(guān)鍵點(diǎn)說明連接主機(jī)名$host mysql;這正是我們在docker-compose.yml中定義的MySQL服務(wù)名。Docker網(wǎng)絡(luò)使得容器間可以通過服務(wù)名直接通信。數(shù)據(jù)庫名、用戶名和密碼需要與docker-compose.yml中environment部分設(shè)置的環(huán)境變量一致。4.5 啟動LNMP服務(wù)棧所有配置和代碼準(zhǔn)備就緒現(xiàn)在可以啟動我們的Docker LNMP環(huán)境了。在docker-lnmp目錄下運(yùn)行docker-compose up -d-d參數(shù)代表“detached”模式讓服務(wù)在后臺運(yùn)行。你會看到Docker開始拉取鏡像如果本地沒有然后創(chuàng)建網(wǎng)絡(luò)、卷并依次啟動三個容器。使用以下命令查看容器狀態(tài)docker-compose ps如果一切正常你應(yīng)該看到三個服務(wù)的狀態(tài)都是“Up”。你也可以用docker logs lnmp-nginx等命令查看特定容器的日志。4.6 測試與訪問打開你的瀏覽器訪問以下地址測試Nginx與PHP訪問http://你的服務(wù)器IP或localhost/info.php。你應(yīng)該能看到標(biāo)準(zhǔn)的PHP信息頁面其中“Server API”一項(xiàng)應(yīng)該顯示為“FPM/FastCGI”。這證明Nginx和PHP-FPM協(xié)同工作正常。測試數(shù)據(jù)庫連接訪問http://你的服務(wù)器IP或localhost/db_test.php。如果配置正確頁面會顯示“數(shù)據(jù)庫連接成功”、MySQL版本號以及插入的測試數(shù)據(jù)。這證明PHP容器能夠通過Docker網(wǎng)絡(luò)成功連接到MySQL容器。至此一個基于Docker的完整LNMP開發(fā)/測試環(huán)境就已經(jīng)搭建并運(yùn)行成功了。你的項(xiàng)目PHP代碼只需放在宿主機(jī)的src/目錄下就能立即生效。5. 進(jìn)階配置、管理與問題排查基礎(chǔ)環(huán)境跑起來只是第一步要讓這個環(huán)境更健壯、更適合生產(chǎn)或團(tuán)隊(duì)協(xié)作還需要考慮更多細(xì)節(jié)。5.1 使用自定義Dockerfile構(gòu)建PHP鏡像官方php:8.2-fpm鏡像很純凈但我們的項(xiàng)目通常需要安裝額外的PHP擴(kuò)展如pdo_mysql,gd,redis等。我們可以通過自定義Dockerfile來構(gòu)建一個包含所需擴(kuò)展的PHP鏡像。在項(xiàng)目根目錄創(chuàng)建Dockerfile# 使用官方PHP-FPM鏡像作為基礎(chǔ) FROM php:8.2-fpm # 安裝系統(tǒng)依賴和PHP擴(kuò)展 RUN apt-get update apt-get install -y \ libpng-dev \ libjpeg-dev \ libfreetype6-dev \ libzip-dev \ zip \ unzip \ git \ curl \ docker-php-ext-configure gd --with-freetype --with-jpeg \ docker-php-ext-install -j$(nproc) \ pdo_mysql \ mysqli \ gd \ zip \ opcache \ apt-get clean rm -rf /var/lib/apt/lists/* # 安裝ComposerPHP包管理工具 COPY --fromcomposer:latest /usr/bin/composer /usr/bin/composer # 設(shè)置工作目錄 WORKDIR /var/www/html然后修改docker-compose.yml中的php-fpm服務(wù)不再使用image而是使用build上下文來構(gòu)建鏡像php-fpm: build: . # 使用當(dāng)前目錄下的Dockerfile構(gòu)建 container_name: lnmp-php-fpm restart: unless-stopped # ... 其余配置保持不變之后運(yùn)行docker-compose up -d --buildCompose會重新構(gòu)建PHP鏡像并啟動服務(wù)。5.2 數(shù)據(jù)備份與遷移由于數(shù)據(jù)庫數(shù)據(jù)持久化在名為mysql_data的Docker卷中備份和遷移變得非常清晰。備份你可以使用docker run命令啟動一個臨時MySQL容器連接到這個數(shù)據(jù)卷并執(zhí)行mysqldump。docker run --rm -v mysql_data:/volume -v $(pwd):/backup alpine \ sh -c apk add --no-cache mysql-client mysqldump -h mysql -u myapp_user -pyour_user_password myapp_db /backup/backup_$(date %Y%m%d_%H%M%S).sql更簡單的方式是直接進(jìn)入MySQL容器執(zhí)行備份docker exec lnmp-mysql mysqldump -u myapp_user -pyour_user_password myapp_db backup.sql遷移將整個項(xiàng)目遷移到新服務(wù)器只需要三步將項(xiàng)目目錄docker-compose.yml,src/,nginx/,php/等拷貝到新服務(wù)器。在新服務(wù)器安裝Docker和Docker Compose。在新服務(wù)器項(xiàng)目目錄下運(yùn)行docker-compose up -d。MySQL容器會自動創(chuàng)建新的空數(shù)據(jù)卷。如果需要恢復(fù)數(shù)據(jù)可以將備份的SQL文件放到mysql/目錄下并在docker-compose.yml中配置掛載如我們之前注釋掉的init.sql掛載或者啟動后手動導(dǎo)入。5.3 常見問題與排查技巧實(shí)錄在實(shí)際操作中你可能會遇到一些問題。這里記錄一些常見坑點(diǎn)和排查思路。問題1訪問info.php顯示“File not found.” 或 空白頁。排查思路檢查文件路徑首先進(jìn)入Nginx容器確認(rèn)文件是否存在。docker exec -it lnmp-nginx sh ls -la /var/www/html/info.php如果不存在說明宿主機(jī)src/目錄到容器的掛載可能失敗了。檢查docker-compose.yml中Nginx和PHP-FPM服務(wù)的volumes配置路徑是否正確。檢查Nginx配置確認(rèn)fastcgi_param SCRIPT_FILENAME設(shè)置正確。確保$document_root指向了正確的目錄/var/www/html。檢查PHP-FPM容器進(jìn)入PHP-FPM容器查看PHP錯誤日志。docker exec -it lnmp-php-fpm bash tail -f /var/log/php_errors.log # 如果配置了的話或者查看Docker容器日志docker logs lnmp-php-fpm檢查網(wǎng)絡(luò)連通性在Nginx容器內(nèi)嘗試ping PHP-FPM服務(wù)。docker exec lnmp-nginx ping php-fpm如果ping不通檢查docker-compose.yml中的networks配置確保所有服務(wù)都在同一個自定義網(wǎng)絡(luò)下。問題2訪問db_test.php顯示數(shù)據(jù)庫連接失敗如“SQLSTATE[HY000] [2002] Connection refused”。排查思路確認(rèn)MySQL容器是否運(yùn)行正常docker-compose ps查看狀態(tài)docker logs lnmp-mysql查看啟動日志確認(rèn)沒有初始化錯誤。檢查連接參數(shù)確認(rèn)db_test.php中使用的host是服務(wù)名mysql端口是3306默認(rèn)數(shù)據(jù)庫名、用戶名、密碼與docker-compose.yml中的environment完全一致。特別注意密碼中的特殊字符可能需要轉(zhuǎn)義。從PHP容器內(nèi)部測試連接進(jìn)入PHP-FPM容器安裝MySQL客戶端并嘗試連接。docker exec -it lnmp-php-fpm bash apt update apt install -y mysql-client # 如果鏡像內(nèi)沒有的話 mysql -h mysql -u myapp_user -p輸入密碼看是否能連接成功。這能直接判斷網(wǎng)絡(luò)和認(rèn)證是否有問題。檢查MySQL用戶權(quán)限有時需要確認(rèn)創(chuàng)建的用戶是否有從任意主機(jī)%連接的權(quán)限。可以在MySQL容器內(nèi)登錄root賬戶進(jìn)行授權(quán)生產(chǎn)環(huán)境需謹(jǐn)慎docker exec -it lnmp-mysql mysql -uroot -p # 輸入root密碼后 GRANT ALL PRIVILEGES ON myapp_db.* TO myapp_user%; FLUSH PRIVILEGES;問題3修改了Nginx或PHP配置后不生效。排查思路重啟服務(wù)修改宿主機(jī)上的配置文件后需要讓容器內(nèi)的服務(wù)重新加載配置。對于Nginxdocker exec lnmp-nginx nginx -s reload對于PHP-FPMdocker exec lnmp-php-fpm kill -USR2 1(發(fā)送信號給主進(jìn)程) 或直接重啟容器docker-compose restart php-fpm檢查配置文件語法Nginx:docker exec lnmp-nginx nginx -tPHP: 重啟時查看容器日志docker logs lnmp-php-fpm看是否有配置解析錯誤。確認(rèn)掛載成功進(jìn)入容器查看配置文件內(nèi)容是否與宿主機(jī)一致。問題4Docker Compose up 時提示端口被占用。排查思路docker-compose.yml中ports映射將宿主機(jī)端口如803306映射到容器。如果宿主機(jī)上已有服務(wù)如本機(jī)ApacheMySQL占用了這些端口就會沖突。解決方案1停止宿主機(jī)上的沖突服務(wù)。解決方案2修改docker-compose.yml中的端口映射例如將80:80改為8080:80這樣通過宿主機(jī)的8080端口訪問容器內(nèi)的80服務(wù)。一個實(shí)用的調(diào)試技巧使用docker-compose logs當(dāng)服務(wù)出現(xiàn)問題時第一時間的日志是最重要的線索。使用以下命令可以查看所有服務(wù)的實(shí)時日志或者查看特定服務(wù)的日志# 查看所有服務(wù)的日志尾部 docker-compose logs # 查看特定服務(wù)如nginx的日志并實(shí)時刷新 docker-compose logs -f nginx # 查看從啟動開始的所有日志 docker-compose logs --tailall6. 生產(chǎn)環(huán)境考量與優(yōu)化建議上面搭建的環(huán)境非常適合本地開發(fā)和測試。但如果要用于生產(chǎn)環(huán)境還需要在安全、性能和監(jiān)控方面做更多工作。6.1 安全加固使用非root用戶運(yùn)行容器默認(rèn)情況下容器內(nèi)的進(jìn)程以root運(yùn)行。可以在Dockerfile中使用USER指令或者在docker-compose.yml中使用user選項(xiàng)指定一個非root用戶來運(yùn)行進(jìn)程。services: php-fpm: image: php:8.2-fpm user: 1000:1000 # 使用宿主機(jī)某個普通用戶的UID和GID # ...限制容器資源在docker-compose.yml中為每個服務(wù)設(shè)置CPU和內(nèi)存限制防止單個容器耗盡主機(jī)資源。services: mysql: # ... deploy: resources: limits: cpus: 1.0 memory: 1G reservations: cpus: 0.5 memory: 512M使用Secret管理敏感信息將數(shù)據(jù)庫密碼等敏感信息直接寫在docker-compose.yml中是不安全的。Docker Swarm或Kubernetes提供了Secrets管理對于單機(jī)Docker可以考慮使用環(huán)境變量文件.env并確保該文件不被提交到版本控制系統(tǒng)。創(chuàng)建.env文件MYSQL_ROOT_PASSWORDyour_very_strong_password_here MYSQL_PASSWORDanother_strong_password在docker-compose.yml中引用environment: MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}僅暴露必要端口生產(chǎn)環(huán)境中MySQL的3306端口不應(yīng)映射到宿主機(jī)公網(wǎng)IP?？梢砸瞥齪orts中的3306:3306僅讓MySQL在Docker內(nèi)部網(wǎng)絡(luò)中被訪問。Web服務(wù)Nginx的80/443端口需要暴露。6.2 性能與可用性為PHP配置OPcacheOPcache可以極大提升PHP性能。確保在php.ini或自定義配置中啟用并優(yōu)化OPcache設(shè)置。Nginx緩存與優(yōu)化根據(jù)項(xiàng)目類型配置Nginx的靜態(tài)文件緩存、代理緩存等。使用更高效的存儲驅(qū)動對于Linuxoverlay2是推薦的存儲驅(qū)動?？梢酝ㄟ^docker info查看。考慮使用Docker Swarm或Kubernetes對于需要高可用的生產(chǎn)環(huán)境單機(jī)Docker Compose不夠。應(yīng)該使用Docker Swarm或Kubernetes來編排容器實(shí)現(xiàn)服務(wù)發(fā)現(xiàn)、負(fù)載均衡、滾動更新和自愈。6.3 監(jiān)控與日志集中式日志將Docker容器的日志收集到ELKElasticsearch, Logstash, Kibana或LokiGrafana等日志系統(tǒng)中便于統(tǒng)一查詢和分析。容器監(jiān)控使用cAdvisor、Prometheus和Grafana監(jiān)控容器的資源使用情況CPU、內(nèi)存、網(wǎng)絡(luò)、磁盤IO。應(yīng)用性能監(jiān)控APM集成如New Relic、Datadog或開源的Pinpoint、SkyWalking等工具監(jiān)控PHP應(yīng)用內(nèi)部的性能瓶頸。從手動安裝配置到使用Docker Compose一鍵編排LNMP環(huán)境的搭建和維護(hù)方式發(fā)生了根本性的變化。容器化帶來的隔離性、一致性和可移植性使得開發(fā)、測試和生產(chǎn)環(huán)境的高度統(tǒng)一成為可能也極大地簡化了運(yùn)維復(fù)雜度。雖然初始的配置需要一些學(xué)習(xí)成本但一旦掌握它所帶來的效率提升和問題減少是巨大的。希望這篇詳細(xì)的指南能幫助你順利踏上Docker化部署之路。