萬盛學電腦網

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

PHP 檔案怎麼打開?從原始碼編輯到本地執行環境建置全攻略

PHP 檔案本質

`.php` 為**文字檔**,內容為 PHP 程式碼 (可混合 HTML/JS/CSS)。**任何文字編輯器**均可開啟編輯:

  • 輕量:Notepad++、EditPlus、Sublime Text、VS Code (推薦)、Vim/Neovim
  • IDE:PhpStorm (專業首選)、NetBeans、Eclipse PDT、Zend Studio
  • 線上:GitHub/GitLab/Web IDE、CodeSandbox、Replit

⚠️ **記事本** 可開但**不支援 UTF-8 無 BOM**、**無語法高亮、無縮排、無編碼轉換**,極易產生 BOM 導致 `header()` 失效、Session 啟動失敗,**強烈不建議**。

為什麼瀏覽器直接開啟 .php 顯示原始碼?

PHP 是**伺服端腳本語言**,需經 **PHP 解析器** 處理後輸出 HTML/JSON/圖片等,**瀏覽器不執行 PHP**。直接雙擊 `.php` 或 `file://` 協定開啟,瀏覽器視為純文字顯示。

本地執行環境建置三大路徑

方案 A:整合包 (Windows/macOS 初學者最快)

工具平台特點
phpStudy (小皮面板)Win圖形介面、一鍵切換 PHP/MySQL/Nginx/Apache 版本、網站管理
XAMPPWin/Mac/Linux跨平台、元件舊 (PHP 常落後)、安全性預設較低
WampServerWinApache/PHP/MySQL/MariaDB、系統匣圖示切換版本
MAMP / MAMP ProMac/WinMac 經典、Pro 版支援多站點、SSL、雲同步
ServBayMac新世代、原生 Apple Silicon、多版本並行、GUI 管理

操作:安裝 → 啟動服務 → 專案放入 `www/` / `htdocs/` / `public_html/` → 瀏覽 `https://localhost/專案/`

方案 B:Docker (團隊/生產一致性首選)

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

方案 C:手動安裝 (深入理解組件交互)

參考《PHP 開發環境建置完整指南》(ID:66060) 逐步配置 Apache/Nginx + PHP-FPM + MySQL。

常見編碼問題:UTF-8 BOM 導致輸出異常

  • 現象:頁面頂端多出空白、header() 失效、`session_start()` 警告 "headers already sent"
  • 原因:編輯器儲存為 **UTF-8 with BOM** (EF BB BF 三位元組)
  • 解決:編輯器另存為 **UTF-8 (無 BOM)**,VS Code 右下角點擊 "UTF-8 with BOM" 切換。

進階:偵錯與開發工具鏈

  • Xdebug 3:斷點、堆疊追蹤、效能分析。`docker-php-ext-install xdebug` + `php.ini` 設定 `xdebug.mode=debug,develop` + `xdebug.client_host=host.docker.internal`
  • PHPStan / Psalm:靜態分析,捕獲型別錯誤、死代碼。
  • PHP_CodeSniffer + PHP-CS-Fixer:程式碼風格統一 (PSR-12)。
  • Composer:依賴管理、`composer require`、`composer dump-autoload`。

總結

**編輯** 用 VS Code/PhpStorm;**執行** 用 phpStudy/Docker;**編碼** 必須 UTF-8 無 BOM;**偵錯** 裝 Xdebug。理解「PHP 在伺服端執行、瀏覽器只收結果」是入門關鍵。

copyright © 萬盛學電腦網 all rights reserved