萬盛學電腦網

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

修改 localhost 為自定義域名:Hosts 檔案配置與虛擬主機實戰

核心原理

瀏覽器解析域名時,優先檢查本地 **Hosts 檔案**(`C:\Windows\System32\drivers\etc\hosts` / `/etc/hosts`),找不到才查詢 DNS。將自定義域名指向 `127.0.0.1` 即可在本機訪問。

Windows 步驟

  1. 以**管理員身分**啟動記事本
  2. 開啟 `C:\Windows\System32\drivers\etc\hosts`
  3. 在末尾新增:
    127.0.0.1    myproject.local
    127.0.0.1    api.myproject.local
    ::1          myproject.local        # IPv6
  4. 儲存,`ipconfig /flushdns` 刷新 DNS 快取

Linux/macOS 步驟

sudo vim /etc/hosts
# 末尾添加
127.0.0.1    myproject.local
::1          myproject.local

Apache 虛擬主機配置(讓不同域名指向不同目錄)

<VirtualHost *:80>
    ServerName myproject.local
    ServerAlias www.myproject.local
    DocumentRoot "D:/www/myproject/public"
    <Directory "D:/www/myproject/public">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog "logs/myproject-error.log"
    CustomLog "logs/myproject-access.log" common
</VirtualHost>

<VirtualHost *:80>
    ServerName api.myproject.local
    DocumentRoot "D:/www/myproject-api/public"
    <Directory "D:/www/myproject-api/public">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Nginx 配置

server {
    listen 80;
    server_name myproject.local www.myproject.local;
    root /var/www/myproject/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

進階:泛域名 / 自動虛擬主機

<VirtualHost *:80>
    ServerName dev.local
    ServerAlias *.dev.local
    VirtualDocumentRoot "D:/www/%1/public"
    <Directory "D:/www">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>
# 訪問 foo.dev.local → D:/www/foo/public
# 訪問 bar.dev.local → D:/www/bar/public

常見問題

現代替代方案:本地開發代理工具

  • Valet (Mac/Linux):`park` 目錄自動映射 `資料夾名.test`,內建 DnsMasq + Nginx
  • DDEV / Lando:Docker 為基礎,自動配置域名、資料庫、郵件捕獲
  • Traefik / Nginx Proxy Manager:反向代理儀表板管理域名、SSL、中間件
  • Hosts 管理工具:SwitchHosts (跨平台 GUI)、HostsFileEditor (Win)

最佳實踐:專案採用 `<專案名>.test` 域名,配合 Valet/DDEV 自動化;團隊共享 `/etc/hosts` 片段納入版本控制(或由基礎設施代碼 Terraform/Ansible 下發)。

copyright © 萬盛學電腦網 all rights reserved
問題解決
修改 hosts 後不生效管理員權限編輯、檢查檔案編碼為 ANSI/UTF-8 無 BOM、執行 `ipconfig /flushdns` (Win) / `sudo dscacheutil -flushcache` (Mac)
Chrome 顯示「不安全」Chrome 強制 `.local` 等 TLD 使用 HTTPS。改用 `.test`、`.localhost`、`.invalid`、`.example` (RFC 6761 保留 TLD) 或配置本地 SSL
Docker 容器內無法解析容器有獨立 `/etc/hosts`,需在 `docker run --add-host=myproject.local:host-gateway` 或 `extra_hosts` 配置
多專案端口衝突統一用 80 埠 + 虛擬主機區分,避免 `:8080`、`:3000` 等