GCPでMauticを構築：アセット（Assets）のファイルアップロード失敗エラーを解決する方法

Mauticは、世界中で広く利用されているオープンソースのマーケティングオートメーション（MA）プラットフォームです。しかし、Google Cloud Platform（GCP）やAWSなどのクラウドサーバー上にMautic環境を構築した際、アセット（Assets）管理画面からファイルをアップロードしようとするとエラーが発生し、アップロードできない事象に直面することがあります。

本稿では、この問題が発生した際の原因特定と具体的な解決手順をわかりやすく共有します。

新規アセットを作成してファイルをアップロードしようとしたところ、以下の画像のように「ファイルのアップロードに失敗しました」というエラーメッセージが表示されました。

Mauticのアセット（Assets）ファイルアップロード失敗画面

まずはサーバーのエラーログ（Error Log）を確認してみます。ログには「MIME type [application/x-httpd-php] for suffix ‘.php’ does not allow serving as static file, access denied!」という警告が出力されており、サーバー側のPHP環境設定が関連している可能性が浮上しました。

そこで、サーバーの php.ini 設定を確認します。CyberPanelなどのサーバー管理コントロールパネルをご利用の場合は、管理画面の「../managephp/editPHPConfigs」から該当PHPバージョンの設定編集画面へ移動できます。

php.ini の設定項目の中から「file_uploads」パラメータを探します。このディレクティブは、サーバーがHTTP経由でのファイルアップロードを許可するかどうかを制御するものです。ここが Off になっていると、Webサイト経由でのあらゆるファイルアップロードがブロックされてしまい、これが先ほどのアップロード失敗の直接的な原因となっていました。

設定ファイルを編集し、file_uploads = On に切り替えてWebサーバー（LiteSpeed / OpenLiteSpeed / Apache等）およびPHPプロセスを再起動（リロード）します。

これだけで、Mauticのアセット画面から正常に画像やPDFなどのファイルをアップロードできるようになります！同様のエラーに遭遇した際は、まず file_uploads 設定を確認してみてください。