萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 檔案基礎:什麼是 .php 檔案、如何開啟編輯、本地執行環境搭建完整教學

什麼是 PHP 檔案

  • 副檔名:`.php` (也可設定 `.phtml`, `.php7` 等)。
  • 本質:包含 PHP 程式碼的純文字檔案,可混合 HTML、CSS、JavaScript。
  • 執行模式:伺服器端解析 (Server-side),Web 伺服器 (Apache/Nginx/IIS) 呼叫 PHP 解釋器執行,輸出 HTML/JSON/圖片等回應給瀏覽器。
  • 全名:PHP: Hypertext Preprocessor (遞迴縮寫)。

如何開啟/編輯 PHP 檔案

關鍵設定:編碼 UTF-8、換行 LF、縮排 4 空格。

PHP 檔案如何「運行」

**PHP 檔案不能像 .exe 直接雙擊執行**,必須透過 Web 伺服器 + PHP 解釋器,或 CLI 模式。

模式一:Web 伺服器模式 (開發/生產標準)

方案 A:整合安裝包 (新手最快上手)

  • Windows:XAMPP (Apache+MariaDB+PHP+Perl)、WampServer、phpStudy (小皮面板)。
  • macOS:MAMP、ServBay。
  • Linux:原生套件管理器 `apt/yum/dnf install php apache2 mariadb`。

安裝後:將 `.php` 檔放入網站根目錄 (如 `htdocs/`, `www/`, `/var/www/html/`) → 瀏覽器訪問 `https://localhost/yourfile.php`。

方案 B:手動配置 (學習原理、生產部署)

Nginx + PHP-FPM (主流生產架構)
# 1. 安裝
sudo apt install nginx php-fpm php-mysql

# 2. Nginx 站點設定 /etc/nginx/sites-available/default
server {
    listen 80;
    root /var/www/html;
    index index.php index.html;

    location / {
        try_files $uri $uri/ =404;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock; # 版本對應
    }
}

# 3. 重啟
sudo systemctl restart nginx php8.1-fpm
Apache + PHP (傳統、.htaccess 支援)
# Ubuntu
sudo apt install apache2 libapache2-mod-php php-mysql
sudo a2enmod rewrite
sudo systemctl restart apache2
# 將 .php 放入 /var/www/html/

方案 C:Docker 容器化 (現代標準、環境一致性)

# docker-compose.yml
version: '3.8'
services:
  web:
    image: nginx:alpine
    ports: ["8080:80"]
    volumes:
      - ./src:/var/www/html
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on: [php]
  php:
    image: php:8.2-fpm
    volumes:
      - ./src:/var/www/html
    # 安裝擴充: docker-php-ext-install pdo_mysql gd redis
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_DATABASE: app
    volumes: [db_data:/var/lib/mysql]
volumes: {db_data: {}}

模式二:CLI 命令列模式 (腳本、定時任務、測試)

# 直接執行
php script.php

# 互動模式
php -a

# 檢查語法
php -l script.php

# 內建開發伺服器 (僅開發測試,單執行緒)
php -S localhost:8000 -t public/
# 瀏覽器開啟 https://localhost:8000

第一支 PHP 程式驗證環境

<?php
// info.php
phpinfo(); // 顯示完整 PHP 環境資訊
?>

瀏覽器開啟 `https://localhost/info.php`,看到紫色表格即成功。

<?php
// hello.php
echo "Hello, PHP World! " . date('Y-m-d H:i:s');
?>

資料庫安裝 (MySQL/MariaDB)

# Ubuntu
sudo apt install mariadb-server
sudo mysql_secure_installation
# 登入建立資料庫/用戶
sudo mysql -u root -p
CREATE DATABASE myapp CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'appuser'@'%' IDENTIFIED BY 'strongpass';
GRANT ALL ON myapp.* TO 'appuser'@'%';
FLUSH PRIVILEGES;

常見問題排查

工具類型推薦工具特點
專業 IDEPhpStorm (付費)、VS Code + PHP Intelephense (免費首選)智能提示、除錯、重構、Git 整合、靜態分析
輕量編輯器Sublime Text, Notepad++, Vim/Neovim啟動快、資源少、需配置外掛支援 PHP
基礎文字編輯器記事本**不推薦**:無語法高亮、編碼問題、無縮排支援
現象可能原因解決
瀏覽器顯示原始碼PHP 模組未載入/副檔名未關聯檢查 Nginx/Apache PHP 模組載入、fastcgi 設定
500/502 錯誤PHP-FPM 未啟動、Socket 路徑錯誤、權限systemctl status php-fpm、檢查 socket 路徑、目錄權限 www-data
中文亂碼字元集不一致PHP/資料庫/HTML/連線全部 utf8mb4
權限拒絕檔案/目錄擁有者非 Web 使用者chown -R www-data:www-data /var/www/html

結語

PHP 檔案只是文字檔,**環境才是關鍵**。新手建議:XAMPP/phpStudy/Docker 快速起步 → 理解「請求 → Web Server → PHP-FPM → 執行腳本 → 回應」流程 → 進階學習 Nginx/Apache 配置、PHP-FPM 池管理、Docker Compose 多服務編排。掌握環境搭建,才能專注於業務邏輯開發。

copyright © 萬盛學電腦網 all rights reserved