Question 1

MariaDB/MySQL で ProjectSend のマイグレーション中に発生する「SQLSTATE[42000]: 1067 Invalid default value for 'created_at'」エラーの修正方法

Accepted Answer

`create_notifications_table` マイグレーションは、`explicit_defaults_for_timestamp=OFF` の場合、MariaDB ≤10.9 または MySQL 5.7 で失敗します。これは、Laravel の strict モードが `NO_ZERO_DATE` を有効にし、`created_at` TIMESTAMP カラムに暗黙的な '0000-00-00 00:00:00' のデフォルト値が設定されてしまうためです。修正方法(上流で適用済み、ProjectSend 2.5.0 の次のリリースで利用可能): マイグレーションファイル内で `$table->timestamp('created_at');` を `$table->timestamp('created_at')->useCurrent();` に変更してカラムに明示的なデフォルト値を指定し、その後 `php artisan migrate --force` を再実行してください。サーバー側の回避策: my.cnf の `[mysqld]` セクションで `explicit_defaults_for_timestamp=ON` を設定し、データベースサーバーを再起動します(注意: MariaDB ≤10.9 ではグローバル専用の変数であり、再起動が必要です)。サーバーの `sql_mode` を変更しても、アプリが接続ごとに上書きするため効果はありません。MySQL 8.0+/MariaDB ≥10.10 は影響を受けません。

Question 2

./update.sh でアップデートした後に SELinux が ProjectSend へのアクセスをブロックする問題（403/permission denied）を解決する方法

Accepted Answer

./update.sh を実行すると、SELinux が ProjectSend のすべてのファイルを user_tmp_t として再ラベル付けするため、enforcing モードでは httpd が読み取れなくなります。これを修正するには、ProjectSend のインストールフォルダで正しい SELinux ファイルコンテキストを復元します:

cd /path/to/projectsend
restorecon -v -R .

ファイルは httpd_sys_content_t に再ラベル付けされ（ls -Z で確認できます）、httpd からのアクセスが直ちに復元されます。これは、アップデート前にフォルダのデフォルトの SELinux コンテキストが正しく設定されていたことを前提としています。メンテナーは main ブランチでこの問題を修正済みのため、今後のリリースではアップデート後に手動で restorecon を実行する必要はありません。

Question 3

ProjectSend APIがレート制限時に429ではなくHTTP 500を返すのはなぜですか？

Accepted Answer

これは ProjectSend 2.7.0 における既知のバグです。レート制限を超過した場合、`app/Modules/Api/Support/ProblemDetails.php`（82行目）が例外のヘッダーを problem+json レスポンスにコピーします。Laravel の `ThrottleRequestsException` は `Retry-After` および `X-RateLimit-*` ヘッダーを整数として設定しますが、Symfony の `ResponseHeaderBag::set()` は `string|array|null` のみを受け付けるため、`TypeError` がスローされ、意図した 429 が 500 に変わってしまいます。修正：メンテナーが `main` ブランチでこの問題にパッチを適用済みで、2.7.0 の次のリリースで公開される予定です。回避策：(1) 最新の main ビルドまたは次のリリースに更新する；(2) `ProblemDetails.php` に手動でパッチを適用し、`$headers->set()` を呼び出す前にヘッダー値を文字列にキャストするか配列でラップする；(3) クライアント側で、スロットル対象のエンドポイント（例：60回/分を超える `GET /api/v1/me`、20回/分を超える `PUT /api/v1/uploads/{id}/parts/{n}`）からの予期しない 500 をレート制限のシグナルとして扱い、バックオフして再試行する。

Question 4

import-orphans.php のパストラバーサル脆弱性を修正する方法は？

Accepted Answer

'files[]'パラメータをサニタイズしてディレクトリトラバーサルを防ぎます。最小限の修正としては、'..'を含むファイル名を拒否します（例：if (strpos($_POST['files'][0], '../') !== false) { die('Invalid file'); }）。堅牢な保護のためには、basename()を使用してパスを除去するか、realpath()で検証して解決されたファイルが意図されたアップロードディレクトリ内に収まることを確認します。この問題が対処されたセキュリティパッチを適用するか、最新バージョンに更新してください。

Question 5

ProjectSendをr1945からr1994にアップグレードした後、FontAwesomeアイコンが壊れているのはなぜですか？

Accepted Answer

これは既知の問題で、r1945からr1994にアップグレードした後、ブラウザがFontAwesome webfontの読み込みを拒否し、すべてのUIアイコンが壊れます。恒久的な修正はr2002以降にアップグレードすることです。一時的な回避策として、r1945のインストールからフォントファイル（assets/fonts/fontawesome-webfont.*）をコピーし、r1994のものを置き換えてください。

ProjectSend

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト