Go to Qiita Advent Calendar 2024 Top
LoginSignup
2
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 1 year has passed since last update.

@kmuro

phpenv install で発生したエラーと解消方法

Posted at

はじめに

  • 普段、PHPを書くことが多いのですがプロダクトによってPHPのバージョンが異なるので簡単にバージョンを切り替えられるようにphpenvのセットアップを行いました
  • phpenv installでPHPをインストール時、エラー → 解消 → エラー　→ 解消 → ...をひたすら繰り返しかなり疲弊しました...（特に7.x系）。ので、インストール成功までに実施したことをマシン交換時などに困らないようここに書き留めておきます

環境

  • macOS Monterey 12.7
  • Apple M1
  • zsh 5.8.1 (x86_64-apple-darwin21.0)
  • anyenv経由でphpenvインストール済み

PHP7.3.33インストール時に発生したエラーと解決方法

  • 環境変数のオプション指定について
    • ~/.anyenv/envs/phpenv/plugins/php-build/share/php-build配下にあるdefault_configure_optionsというファイルに記述する方法もあるみたいなのですが、記述しても認識してくれないオプションがあったのでコマンド実行時に直接指定してしまうのが確実です
    • zlibとbzip2については上記ファイルに記述することで認識してくれたようなのでコマンド実行時にオプション指定は行いませんでした
    • ちなみに記述したオプション以下２つ
      • --with-zlib-dir=$(brew --prefix zlib)
      • --with-bz2=$(brew --prefix bzip2)
  • 1 ~ 8のエラーを上から順番に解消していきました
    • ビルドに成功した最終的な環境変数付きの実行コマンドは8.の最後に記述してあります

1. configure: error: jpeglib.h not found

  • 確認したこと
    • jpeg（libjpeg）がインストールされているか → されていた
      • brew info jpeg
  • 試したこと
    • 環境変数PHP_BUILD_CONFIGURE_OPTSに--with-jpeg-dirオプションを指定
    • PHP_BUILD_CONFIGURE_OPTS="--with-jpeg-dir=$(brew --prefix jpeg)" phpenv install 7.3.33

2. configure: error: png.h not found.

  • 確認したこと
    • libpngがインストールされているか → されていた
      • brew info libping
  • 試したこと
    • 環境変数PHP_BUILD_CONFIGURE_OPTSに--with-png-dirオプションを指定
    • PHP_BUILD_CONFIGURE_OPTS="\ 
--with-jpeg-dir=$(brew --prefix jpeg) \
--with-png-dir=$(brew --prefix libping)" phpenv install 7.3.33

3. configure: error: Please specify the install prefix of iconv with --with-iconv=DIR

  • 確認したこと
    • libiconvがインストールされているか → されていた
      • brew info libiconv
  • 試したこと
    • 環境変数PHP_BUILD_CONFIGURE_OPTSに--with-iconvオプションを指定
    • PHP_BUILD_CONFIGURE_OPTS="\ 
--with-jpeg-dir=$(brew --prefix jpeg) \
--with-png-dir=$(brew --prefix libping) \
--with-iconv=$(brew --prefix libiconv)" phpenv install 7.3.33

4. configure: error: Cannot find libtidy

  • 確認したこと
    • libtidy(tidy-html5)がインストールされているか → されていた
      • brew info libtidy
      • Error: No available formula with the name "libtidy"
        • 調べてみるとbrewではtidy-html5が入っていれば良いらしい
      • brew info tidy-html5
        • 入っていた
  • 試したこと
    • 環境変数PHP_BUILD_CONFIGURE_OPTSに--with-tidyオプションを指定
    • PHP_BUILD_CONFIGURE_OPTS="\ 
--with-jpeg-dir=$(brew --prefix jpeg) \
--with-png-dir=$(brew --prefix libping) \
--with-iconv=$(brew --prefix libiconv) \
--with-tidy=$(brew --prefix tidy-html5)" phpenv install 7.3.33

5. opensslに関するエラー

エラーログで問題となっていた箇所抜粋
  • RSA_SSLV23_PADDINGがビルドの時に使っているOpenSSL3.0では削除もしくは非推奨となっているのでエラーになってしまっている模様
  • /var/tmp/php-build/source/7.3.33/ext/openssl/openssl.c:1485:51: error: use of undeclared identifier 'RSA_SSLV23_PADDING'
                REGISTER_LONG_CONSTANT("OPENSSL_SSLV23_PADDING", RSA_SSLV23_PADDING, CONST_CS|CONST_PERSISTENT);
  • 試したこと
    • OpenSSL@1.1をインストール
      • brew install openssl@1.1
    • 環境変数PHP_BUILD_CONFIGURE_OPTSに--with-opensslオプションを指定
    • PHP_BUILD_CONFIGURE_OPTS="\ 
--with-jpeg-dir=$(brew --prefix jpeg) \
--with-png-dir=$(brew --prefix libping) \
--with-iconv=$(brew --prefix libiconv) \
--with-tidy=$(brew --prefix tidy-html5) \
--with-openssl=$(brew --prefix openssl@1.1)" phpenv install 7.3.33

6. libxml2に関するエラー

エラーログの一部を抜粋
  • ビルド時に利用しているlibxml2にxmlSaveNoEmptyTagsが宣言されていないためエラーとなっている模様
    • brewにインストールされていたlibxml2は2.12.0 
    • /var/tmp/php-build/source/7.3.33/ext/dom/document.c:1659:4: error: use of undeclared identifier 'xmlSaveNoEmptyTags'
                        xmlSaveNoEmptyTags = 1;
                        ^
/var/tmp/php-build/source/7.3.33/ext/dom/document.c:1664:4: error: use of undeclared identifier 'xmlSaveNoEmptyTags'
                        xmlSaveNoEmptyTags = saveempty;
                        ^
9 errors generated.
make: *** [ext/dom/document.lo] Error 1
make: *** Waiting for unfinished jobs....
  • 試したこと

    • 古いバージョン(今回は2.9.4)のlibxml2をインストール

      • wgetで2.9.4のlibxml2をダウンロード&ビルド
      • wget http://xmlsoft.org/sources/libxml2-2.9.4.tar.gz
tar xzvf libxml2-2.9.4.tar.gz
cd libxml2-2.9.4
./configure --prefix={任意のフォルダパス}
make
make install
      • 5.のmakeコマンドでエラー
      • /Applications/Xcode.app/Contents/Developer/usr/bin/make  all-recursive
Making all in include
Making all in libxml
make[3]: Nothing to be done for `all'.
make[3]: Nothing to be done for `all-am'.
Making all in .
  CC       xmlIO.lo
xmlIO.c:1450:52: error: use of undeclared identifier 'LZMA_OK'
    ret =  (__libxml2_xzclose((xzFile) context) == LZMA_OK ) ? 0 : -1;
                                                   ^
1 error generated.
make[2]: *** [xmlIO.lo] Error 1
make[1]: *** [all-recursive] Error 1
make: *** [all] Error 2
13:24:50 [ libxml2-2.9.4 ] %
      • 4. ./configureを実行する際に以下のように環境変数を指定して実行
      • LDFLAGS="-L$(brew --prefix xz)/lib" CPPFLAGS="-I$(brew --prefix xz)/include" ./configure --prefix={任意のフォルダパス}
      • これらの手順でlibxml2の2.9.4のインストールが完了

    • 環境変数PHP_BUILD_CONFIGURE_OPTSに--with-libxml-dirオプションを指定

    • PHP_BUILD_CONFIGURE_OPTS="\ 
--with-jpeg-dir=$(brew --prefix jpeg) \
--with-png-dir=$(brew --prefix libping) \
--with-iconv=$(brew --prefix libiconv) \
--with-tidy=$(brew --prefix tidy-html5) \
--with-openssl=$(brew --prefix openssl@1.1) \
--with-libxml-dir={2.9.4をインストールしたフォルダパス}" phpenv install 7.3.33

7. icu4cに関するエラー

エラーログ抜粋
  • PHP7.3のintl拡張がbrewにインストールされているicu4cのバージョンと互換性が無いのでエラーが出ている模様
    • brewに入っていたicu4cのバージョンは73.2だった
    • In file included from /var/tmp/php-build/source/7.3.33/ext/intl/breakiterator/breakiterator_class.cpp:23:
/var/tmp/php-build/source/7.3.33/ext/intl/breakiterator/codepointiterator_internal.h:42:17: error: virtual function 'operator==' has a different return type ('UBool' (aka 'signed char')) than the function it overrides (which has return type 'bool')
                virtual UBool operator==(const BreakIterator& that) const;
                        ~~~~~ ^
/opt/homebrew/Cellar/icu4c/73.2/include/unicode/brkiter.h:127:18: note: overridden virtual function is here
    virtual bool operator==(const BreakIterator&) const = 0;
            ~~~~ ^
1 error generated.
make: *** [ext/intl/breakiterator/breakiterator_class.lo] Error 1
make: *** Waiting for unfinished jobs.
  • 試したこと
    • 古いバージョンのicu4cをインストールする（今回は64.2）
      • brewで任意のバージョンをインストールする方法があったので以下を実行
      • brew tap-new icu4c-prev/taps
brew extract icu4c icu4c-prev/taps --version 64.2
brew extract icu4c icu4c-prev/taps --version 64
brew tap homebrew/core
brew extract icu4c icu4c-prev/taps --version 64.2
brew install icu4c-prev/taps/icu4c@64.2
xcode-select --install #インストールを求められたので実行
brew install icu4c-prev/taps/icu4c@64.2
# icu4c@64.2がリストに追加されているはず
brew list
    •  環境変数PHP_BUILD_CONFIGURE_OPTSに--with-icu-dirオプションを指定
    • PHP_BUILD_CONFIGURE_OPTS="\ 
--with-jpeg-dir=$(brew --prefix jpeg) \
--with-png-dir=$(brew --prefix libping) \
--with-iconv=$(brew --prefix libiconv) \
--with-tidy=$(brew --prefix tidy-html5) \
--with-openssl=$(brew --prefix openssl@1.1) \
--with-libxml-dir={2.9.4をインストールしたフォルダパス}　\
--with-icu-dir=$(brew --prefix icu4c@64.2" phpenv install 7.3.33

8.pcre関連のエラー

エラーログの一部を抜粋
  • バンドルされているpcreを使うと何故か以下のようなエラーが発生する模様
    • pearでPHP_Archiveをインストールすれば良いのかと思っていたけど違いました 
      /var/tmp/php-build/source/7.3.33/sapi/phpdbg/phpdbg_out.c:879:15: warning: passing an object that undergoes default argument promotion to 'va_start' has undefined behavior [-Wvarargs]
        va_start(va, escape_xml);
                     ^
/var/tmp/php-build/source/7.3.33/sapi/phpdbg/phpdbg_out.c:875:79: note: parameter of type 'zend_bool' (aka 'unsigned char') is declared here
PHPDBG_API int _phpdbg_xml_asprintf(char **buf, const char *format, zend_bool escape_xml, ...) {
                                                                              ^
1 warning generated.
PEAR package PHP_Archive not installed: generated phar will require PHP's phar extension be enabled.
make: *** [ext/phar/phar.phar] Bus error: 10
  • 確認したこと
    • pcre2がインストールされているか → されていた
      • brew info pcre2
  • 試したこと
    • 環境変数PHP_BUILD_CONFIGURE_OPTSに--with-external-pcreオプションを指定
      • エラーは解消されず内容も上記と同じまま
    • 環境変数PHP_BUILD_CONFIGURE_OPTSに--with-pcre-regexオプションを指定
      • こちらが正解でした
      • PHP7.3までは外部のpcreを利用する場合はこのオプションが有効らしい
    • 完成 
      PHP_BUILD_CONFIGURE_OPTS="\ 
--with-jpeg-dir=$(brew --prefix jpeg) \
--with-png-dir=$(brew --prefix libping) \
--with-iconv=$(brew --prefix libiconv) \
--with-tidy=$(brew --prefix tidy-html5) \
--with-openssl=$(brew --prefix openssl@1.1) \
--with-libxml-dir={2.9.4をインストールしたフォルダパス}　\
--with-icu-dir=$(brew --prefix icu4c@64.2 \
--with-pcre-regex=$(brew --prefix pcre2)" phpenv install 7.3.33

PHP8.2.12インストール時に発生したエラーと解決方法

  • PHP8.2.12に関しては新しいバージョンなので7.3.33の時より発生するエラーがかなり少なかったです
    • opensslやlibxmlの古いバージョンを使う必要もなくインストールに成功しました
  • 後述するコマンドを実行する前に.zshrcに以下を記述
    • export PKG_CONFIG_PATH=/opt/homebrew/opt/jpeg/lib/pkgconfig
    • 自分の場合は上記のみでインストールに成功しましたが人によっては他にもexportする必要があるかもしれないです
  • PHP_BUILD_CONFIGURE_OPTS="\
--with-iconv=$(brew --prefix libiconv) \
--with-tidy=$(brew --prefix tidy-html5)" phpenv install 8.2.12

    [Success]: Built 8.2.1 successfully.

さいごに

  • brewのnew-tapとextractコマンドは今回のセットアップで初めて知ったのでちょっとした収穫でした
  • To: 未来の自分
    • 故障等でマシンの交換になった時、この記事を未来の自分が見てPHPのセットアップがスムーズに出来ることを祈っています:innocent:
    • 今回出なかったエラーが来たらphpenv使うのはやめてshivammathur/homebrew-phpを利用してください:metal:
2
2
1

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
2
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?