PHP 標籤風格四種形式

PHP 解析器只處理標籤內的程式碼，HTML 等非 PHP 內容直接輸出。四種風格兼容性與推薦度不同：

風格	開始標籤	結束標籤	啟用條件	推薦度
標準風格	<?php	?>	永遠啟用	⭐⭐⭐⭐⭐ 唯一官方保證
短標籤	<?	?>	short_open_tag=On	⭐⭐ 不可攜、XML 衝突
ASP 風格	<%	%>	asp_tags=On（PHP 7 移除）	❌ 已棄用
Script 風格	<script language="php">	</script>	永遠啟用	⭐ 過時、冗長

標準風格範例（唯一推薦）

<?php
// 每句以分號結尾
echo 'Hello, World!';
$name = 'PHP';
echo "Welcome to {$name}";
?>

短標籤啟用方式（不建議）

; php.ini
short_open_tag = On
; 重啟 PHP-FPM/Apache 生效

風險：<?xml 會被誤判為 PHP 標籤導致解析錯誤，XML/HTML5 文件共存時極易出問題。

PHP 註解三種語法

類型	語法	範例	用途
單行註解	// 或 #	// 這是註解	行內說明、暫時停用程式碼
多行註解	/* ... */	/* 多行 說明 */	區塊說明、大段暫時停用
文件註解	/** ... */	/** @var string $name */	PHPDoc 標準、IDE 智能提示、自動生成文件

文件註解標準標籤

<?php
/**
 * 類別簡短說明
 * 
 * 詳細說明可跨多行
 * 
 * @package    MyApp\Models
 * @author     Author Name <email@example.com>
 * @version    1.0.0
 * @since      2024-01-15
 * @property   string $name 使用者名稱
 * @method     void sendEmail(string $to) 發送郵件
 */
class User {
    /** @var string 使用者名稱 */
    public $name;
}
?>

PHP 檔案命名規範

1. 以字母或底線開頭：user.php, _config.php
2. 後續可含字母、數字、底線：user_profile_v2.php
3. 不可含：空格、中文、特殊符號（-、.、@ 等）
4. 語意化命名：OrderController.php、UserRepository.php、calculate_tax.php
5. 類別檔案建議 PascalCase，腳本檔案 snake_case

實戰：建立第一個 PHP 專案（以 phpStudy + VS Code 為例）

1. 安裝 phpStudy（整合 Apache/Nginx + PHP + MySQL）
2. 啟動服務，預設根目錄 C:\phpstudy_pro\WWW
3. 建立專案資料夾 WWW\myapp
4. 建立 index.php：

   <?php
   echo '<h1>Hello, PHP!</h1>';
   phpinfo();
   ?>

5. 瀏覽器訪問 https://localhost/myapp/

常見新手錯誤與解決

錯誤現象	原因	解決
瀏覽器顯示原始碼	PHP 未解析，Web Server 未載入 PHP 模組	檢查 Apache LoadModule php_module、Nginx fastcgi_pass
空白頁面	語法錯誤且 display_errors=Off	php.ini 設定 display_errors=On、error_reporting=E_ALL
中文亂碼	檔案編碼非 UTF-8 或 HTTP 標頭缺 charset	編輯器存檔選 UTF-8、header('Content-Type: text/html; charset=utf-8')
短標籤不工作	short_open_tag=Off	改用標準標籤 <?php（推薦）

總結

• 永遠使用 標準標籤 <?php ... ?>
• 養成撰寫 PHPDoc 文件註解 習慣
• 檔案命名遵循 語意化 + snake_case/PascalCase
• 開發環境開啟 完整錯誤回報
• 檔案編碼統一 UTF-8 無 BOM

扎實的語法基礎是寫出可維護、可擴充 PHP 程式的關鍵。