萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

解決 PHP 編譯 memcached 擴展找不到 libmemcached/memcached.h 錯誤

CentOS 6 / PHP 5.4 環境下使用 pecl install memcached 報錯 php_libmemcached_compat.h:5:40: error: libmemcached-1.0/memcached.h: No such file or directory。主因 php_memcached 原始碼預期 header 在 libmemcached/memcached.h,但系統安裝路徑為 /usr/include/libmemcached/memcached.h。本文提供修改原始碼路徑與手動編譯 libmemcached 兩種解法。

方案一:修改擴展原始碼 include 路徑 (快速)

  1. 下載原始碼:
  2. wget https://pecl.php.net/get/memcached -O memcached.tgz
    tar zxf memcached.tgz
    cd memcached-2.2.0b1
    
  3. 修正 php_libmemcached_compat.h:
  4. # 修改前
    #include 
    # 修改後 (使用系統實際路徑)
    #include 
    
  5. 編譯安裝:
  6. phpize
    ./configure --disable-memcached-sasl
    make && make install
    
  7. 啟用擴展:
  8. echo "extension=memcached.so" > /etc/php.d/memcached.ini
    systemctl restart php-fpm
    

方案二:手動編譯安裝 libmemcached 1.0.17 (根治、版本可控)

  1. 移除系統套件:
  2. yum remove libmemcached libmemcached-devel
    
  3. 編譯安裝 libmemcached:
  4. 
    wget https://launchpad.net/libmemcached/1.0/1.0.17/+download/libmemcached-1.0.17.tar.gz
    tar zxf libmemcached-1.0.17.tar.gz
    cd libmemcached-1.0.17
    ./configure
    make && make install
    # 預設安裝至 /usr/local/include/libmemcached/memcached.h
    
  5. 修正 memcached 擴展原始碼 include 路徑指向 /usr/local/include/libmemcached/memcached.h。
  6. 編譯安裝 PHP memcached 擴展:
  7. 
    cd ../memcached-2.2.0b1
    phpize
    ./configure
    make && make install
    
  8. 驗證:
  9. 
    ls /usr/lib64/php/modules/memcached.so
    php -m | grep memcached
    

常見衍生錯誤與對策

  • configure: error: no, sasl.h is not available → 加 --disable-memcached-sasl 或 yum install cyrus-sasl-devel。
  • php_libmemcached_compat.h:53: error: expected '='... → 版本不相容,改用方案二手動編譯匹配版本的 libmemcached。
生產建議:優先使用方案二,鎖定 libmemcached 版本,避免系統更新導致 ABI 不相容。PHP 7+ 請改用 pecl install memcached-3.x 並確認相容性。
copyright © 萬盛學電腦網 all rights reserved