document.writeln('');
PHP連接MySQL失敗需依次排查:一、確認(rèn)MySQL服務(wù)運(yùn)行;二、核對連接參數(shù)(主機(jī)、端口、憑據(jù));三、檢查用戶權(quán)限與Host綁定;四、排除防火墻/SELinux攔截;五、確保mysqli或pdo_mysql擴(kuò)展已啟用。

如果在PHP腳本中嘗試連接MySQL數(shù)據(jù)庫時(shí)出現(xiàn)錯(cuò)誤,通常表現(xiàn)為mysqli_connect()或PDO::__construct()調(diào)用失敗,并返回類似“Connection refused”、“Access denied”或“Unknown database”等提示。以下是針對該問題的多種排查與修復(fù)方法:
PHP無法連接MySQL的根本前提之一是MySQL服務(wù)未啟動,此時(shí)連接請求會被系統(tǒng)直接拒絕。
1、在Linux服務(wù)器上執(zhí)行命令 sudo systemctl status mysql 或 sudo service mysqld status 查看服務(wù)狀態(tài)。
2、若顯示 inactive,則運(yùn)行 sudo systemctl start mysql 啟動服務(wù)。
立即學(xué)習(xí)“PHP免費(fèi)學(xué)習(xí)筆記(深入)”;
3、在Windows環(huán)境下,打開“服務(wù)”管理器,查找名為 MySQL80 或 MySQL 的服務(wù),確認(rèn)其狀態(tài)為“正在運(yùn)行”。
PHP連接語句中使用的主機(jī)地址、端口、用戶名、密碼及數(shù)據(jù)庫名必須與MySQL實(shí)際配置完全一致,任一字段錯(cuò)誤均會導(dǎo)致連接失敗。
1、確認(rèn)PHP代碼中使用的主機(jī)名不是 localhost(該值在部分系統(tǒng)中會強(qiáng)制走Unix socket),可嘗試替換為 127.0.0.1 強(qiáng)制使用TCP/IP協(xié)議。
2、檢查端口號是否為MySQL實(shí)際監(jiān)聽端口,默認(rèn)為 3306;若修改過配置,需同步更新PHP連接字符串中的 port 參數(shù)。
3、使用命令行工具手動驗(yàn)證憑證:執(zhí)行 mysql -u 用戶名 -p -h 127.0.0.1 -P 3306,輸入密碼后觀察是否能成功登錄。
MySQL用戶賬戶不僅需存在,還必須被授權(quán)從PHP所在主機(jī)(可能是本地或遠(yuǎn)程)訪問指定數(shù)據(jù)庫,且賬號未被限制來源IP或域名。

訪問全球海洋潮汐模型。功能包括查詢指定日期、時(shí)間和地點(diǎn)的潮高、潮汐極值及格點(diǎn)天氣數(shù)據(jù)。
1、登錄MySQL后執(zhí)行 SELECT User, Host FROM mysql.user; 查看當(dāng)前用戶列表及其允許連接的Host值。
2、若PHP運(yùn)行在本機(jī)但用戶Host列為 localhost,而連接時(shí)使用的是 127.0.0.1,則可能因MySQL對二者視為不同主機(jī)而拒絕連接;此時(shí)應(yīng)創(chuàng)建Host為 127.0.0.1 或 % 的同名用戶。
3、執(zhí)行 GRANT ALL PRIVILEGES ON 數(shù)據(jù)庫名.* TO 用戶名@% IDENTIFIED BY 密碼; FLUSH PRIVILEGES; 授予必要權(quán)限并刷新權(quán)限表。
即使MySQL服務(wù)運(yùn)行正常且憑據(jù)無誤,網(wǎng)絡(luò)層攔截也可能導(dǎo)致連接超時(shí)或被拒絕,尤其在云服務(wù)器或企業(yè)內(nèi)網(wǎng)環(huán)境中常見。
1、在Linux服務(wù)器上運(yùn)行 sudo ufw status(Ubuntu)或 sudo firewall-cmd --list-all(CentOS/RHEL)查看防火墻是否放行3306端口。
2、如未放行,執(zhí)行 sudo ufw allow 3306 或 sudo firewall-cmd --add-port=3306/tcp --permanent && sudo firewall-cmd --reload 開啟端口。
3、對于啟用SELinux的系統(tǒng),運(yùn)行 sudo setsebool -P httpd_can_network_connect_db 1 允許Web服務(wù)器進(jìn)程連接數(shù)據(jù)庫。
PHP需加載對應(yīng)數(shù)據(jù)庫驅(qū)動擴(kuò)展(如mysqli或pdo_mysql)才能發(fā)起連接請求,缺少擴(kuò)展將導(dǎo)致函數(shù)未定義或連接機(jī)制不可用。
1、在PHP腳本中插入 var_dump(extension_loaded(mysqli)); 或 var_dump(extension_loaded(pdo_mysql)); 檢查擴(kuò)展是否已加載。
2、若返回false,編輯php.ini文件,取消以下行的注釋:extension=mysqli 和/或 extension=pdo_mysql(Windows下為 extension=php_mysqli.dll 等)。
3、保存php.ini后重啟Web服務(wù)器(如Apache執(zhí)行 sudo systemctl restart apache2,Nginx+PHP-FPM則執(zhí)行 sudo systemctl restart php-fpm)。