FreeScoutの「deprecated since 8.5」エラーを修正
PHP 8.5に移行した後にFreeScoutの機能が動作しなくなった場合は、FreeScoutのログで次の内容で終わるメッセージを確認してください is deprecated since 8.5)。それぞれが原因となったファイルを特定します。そのファイルを所有するモジュールまたはFreeScoutコンポーネントを更新し、キャッシュをクリアして、キューワーカーを再起動します。
PHP 8.5はUbuntu 26.04のデフォルトPHPバージョンであるため、これらのエラーはオペレーティングシステムのアップグレード直後に頻繁に表示されます。
症状
FreeScout自体は通常まだ読み込まれますが、個々の機能が失敗します:
- モジュールの 接続をテスト ボタンがサーバーに到達できないと報告します。
- 同期、取得、AI 下書きなどのバックグラウンドジョブが結果を出さなくなる。
- アップグレード前に動作していた統合が沈黙する。
- 設定ページまたはアクションがサーバーエラーを返します。
明らかな兆候は curl 同じアドレスへのアクセスはサーバーのコマンドラインからは機能するのに、モジュールが接続できないと表示する場合。
ログメッセージ
FreeScout のアプリケーションログを開く (管理 > ログ > アプリログ)、または storage/logs/laravel-<date>.log サーバーで)。PHP 8.5の非推奨警告は次のようになります:
Function curl_close() is deprecated since 8.5, as it has no effect since PHP 8.0
Function imagedestroy() is deprecated since 8.5, as it has no effect since PHP 8.0
chr(): Providing a value not in-between 0 and 255 is deprecated
Using null as an array offset is deprecated, use an empty string insteadモジュールは通常、失敗したジョブやリクエストなど、メッセージの周囲に独自のコンテキストを追加します。
発生する理由
PHP 8.5はいくつかの古い関数とエッジケースを非推奨にします。次のようないくつかは curl_close() および imagedestroy())、PHP 8.0以降では何も行わないため、古いコードは依然としてそれらを呼び出します。
ほとんどの PHP アプリでは、非推奨の警告はログ内の警告にすぎません。FreeScout はすべての非推奨通知をエラーとして扱います。そのため、リクエストが正常に完了した後、次のような残存する呼び出しで失敗することがあります curl_close())。URL、APIキー、ネットワーク、PHP拡張機能は通常問題ありません。
修正: 影響を受けるコードを更新
ログエントリ内のファイルを検索
完全なログエントリを開きます。次の中のパスModules/<Name>そのモジュールを指します。配下のパスapp/またはvendor/FreeScout 自体を指します。そのモジュールまたはFreeScoutを更新
開く 管理 > モジュール そして利用可能な更新をインストールするか、モジュール開発者のサイトでPHP 8.5対応リリースを確認してください。FreeScout自体については、最新リリースに更新してください。キャッシュをクリアしてキューワーカーを再起動
FreeScoutディレクトリからこれらを実行してください。キューワーカーは長時間実行プロセスであるため、再起動するまで古いコードを使い続けます。ターミナルphp artisan freescout:clear-cache php artisan queue:restart失敗したものを再試行
クリック 接続をテスト 再度、停止した同期を再実行し、新しいバックグラウンドジョブが完了することを確認してください。
動作したことを確認
- 失敗した機能が再び動作します。
- 新しいログエントリはもはや言及しません
is deprecated since 8.5.
まだ利用可能なアップデートがない場合
開発者が修正をリリースするまでFreeScoutをPHP 8.4で実行してください。PHP 8.4はこれらの関数を非推奨として扱わないため、同じコードがそこで正常に動作します。
FreeScout が使用する両方の PHP バージョンを切り替えます。 管理 > システム Web サーバーが実行しているバージョンを表示します。キューワーカーと cron はコマンドライン PHP を使用するため、確認してください php -v サーバーでも。次にPHP-FPMまたはWebサーバー、およびキューワーカーを再起動します。
完全な移行については、次を参照してください FreeScoutをPHP 8.5にアップグレード.
ReplyRabbitとPHP 8.5