FreeScoutをPHP 8.5にアップグレード(Ubuntu 26.04チェックリスト)
FreeScout を PHP 8.5 に移行する前に、FreeScout と実行中のすべてのモジュールが対応していることを確認し、PHP 拡張機能を確認し、キューワーカーを再起動し、ログで次を監視してください deprecated since 8.5 メッセージ。Ubuntu 26.04はデフォルトでPHP 8.5をインストールするため、OSアップグレードが変更を引き起こすことがよくあります。
これはほとんどのPHPアプリよりもFreeScoutにとって重要です。FreeScoutが非推奨通知を処理する方法のためです。
PHP 8.5がFreeScoutモジュールを壊す可能性がある理由
各PHPリリースは一部の古い関数を非推奨にします。PHP 8.5は、PHP 8.0以降何もしていないいくつかの関数を非推奨にします。これには次が含まれます curl_close(), imagedestroy())、および xml_parser_free())。また、以下を使用するなどの一部のエッジケースを非推奨にします null 配列キーとして、または渡す chr() 0から255の範囲外の値。
ほとんどのPHPアプリは非推奨警告をログに記録して続行します。FreeScoutはすべての非推奨通知をエラーに変えるため、残った1つの呼び出しがそれをヒットしたリクエストやバックグラウンドジョブを停止させます。モジュールはインストールされて正常に見えても、行うすべての接続が失敗する可能性があります。
アップグレード後にこれらのエラーが表示される場合は、 FreeScoutの「deprecated since 8.5」エラーを修正 原因となるモジュールの特定と修正の手順を説明します。
アップグレード前に
- サポートを確認: PHP 8.5 に関する FreeScout のリリースノートとシステム要件を読み、インストールされている各モジュールに PHP 8.5 対応のリリースがあることを確認してください。
- 最初にモジュールを更新: 現在のPHPバージョンにいる間にそれらの更新をインストールして、移動前にすべてのモジュールが準備できるようにします。
- バックアップ: FreeScout ディレクトリ、データベース、PHP 設定ファイルのコピーを取得します。
- コピーでテスト: 可能であれば、まずヘルプデスクのステージングコピーでアップグレードを実行してください。
アップグレード後
FreeScoutが実行しているPHPバージョンを確認してください
開く 管理 > システム)。ウェブサーバーが使用するPHPバージョンを表示し、FreeScoutが必要とするPHP拡張機能を一覧表示して、不足しているものをフラグ付けします。コマンドラインPHPを一致させる
実行php -vサーバーで。キューワーカーとschedule:runcronはコマンドラインPHPを使用するため、Webサーバーのバージョンと異なる場合があります。両方が同じバージョンと同じ拡張機能で実行される必要があります。拡張機能と設定を再インストール
新しいPHPバージョンには独自の拡張機能パッケージが付属し、php.iniファイル。拡張機能をインストールします 管理 > システム 欠落としてマークし、次に以下のようなカスタム設定を再適用しますupload_max_filesizeおよびpost_max_size.Webサーバーを新しいPHPに向ける
PHP-FPMを使用している場合は、ウェブサーバーがPHP 8.5のFPMソケットまたはサービスを使用していることを確認し、PHP-FPMとウェブサーバーを再起動してください。キャッシュをクリアしてキューワーカーを再起動
古いコードでプロセスが実行され続けないよう、FreeScoutディレクトリからこれらを実行してください:ターミナルphp artisan freescout:clear-cache php artisan queue:restart
ログで確認すべきこと
開く 管理 > ログ > アプリログ ヘルプデスクをしばらく使用した後。検索:
is deprecated since 8.5)、まだPHP 8.5対応でないモジュールまたはファイルを指しています。Providing a value not in-between 0 and 255 is deprecated)、からchr()呼び出し。Using null as an array offset is deprecated.
各エントリはファイル名を示します。次の下のパス Modules/<Name> どのモジュールに更新が必要かを示します。
アウトバウンド接続を行う機能をテストしてください。これらが最初に失敗するためです: メール取得、AI プロバイダー、ナレッジソース、Linear、Jira、Slack、ストアコネクタなどの統合。モジュールが提供する場合 接続をテスト ボタンがあれば、それを使用してください。
問題が発生した場合
更新を待つ間、FreeScoutをPHP 8.4に戻してください。PHP 8.4はこれらの関数を非推奨として扱わないため、同じコードがそこで正常に実行されます。WebサーバーとコマンドラインPHPの両方を切り替え、PHP-FPM、Webサーバー、キューワーカーを再起動してください。