Cardix は一般的な Web ホスティングで動作する PHP アプリケーションです。インストール前に以下の要件をご確認ください。セットアップページがほとんどの項目を自動で確認し、結果を サーバーチェック に表示します(Cardix をインストールする を参照)。
PHP バージョン
| 要件 | 値 |
|---|---|
| PHP | 7.4 以降。PHP 8.1 以降を推奨 |
| 動作確認済み | PHP 7.4 および PHP 8.5 |
| データベースサーバー | 不要。Cardix はデータを専用フォルダー内のファイルに保存します |
| WordPress | 不要。Cardix は単独で動作するアプリケーションです |
PHP 拡張機能
セットアップページでは、各項目が 必須 または 推奨 として表示されます。
| サーバーチェック項目 | レベル | Cardix に必要な理由 |
|---|---|---|
| PHP バージョン 7.4 以降 | 必須 | Cardix は古い PHP では動作しません |
| JSON 関数 | 必須 | 設定とデータは JSON ファイルとして保存されます |
| セッションのサポート | 必須 | サインインと非公開リンクに PHP セッションを使用します |
| ZipArchive(フォントと既製テンプレート) | 必須 | フォントと既製テンプレートはパッケージ内の ZIP ファイルとして提供されます |
| パッケージファイル | 必須 | インストール用 ZIP のすべてのファイルが揃っており、変更されていない必要があります |
| mbstring 拡張機能 | 推奨 | ない場合、トルコ語やアラビア語のテキスト処理が不安定になることがあります |
| OpenSSL 拡張機能 | 推奨 | ない場合、ライセンスやセキュリティ機能が動作しないことがあります |
| ARN API へのアクセス(cURL または allow_url_fopen) | 推奨 | ない場合、ARN Smart でライセンスを有効化できません |
| fileinfo 拡張機能(アップロードのセキュリティ) | 推奨 | ない場合、アップロードされたファイルのチェックが緩くなります |
| GD 拡張機能 | 推奨 | ない場合、カード画像を作成できません |
| FreeType(imagettftext) | 推奨 | GD が TrueType フォントでテキストを描画するために使用します |
必須 項目が不足している場合、セットアップを続行できません。推奨 項目のみが不足している場合は LIMITED モードでインストールできますが、上記の機能は動作しません。実際には、Cardix を正常に使うには、カード画像の作成に FreeType 付きの GD、ライセンスの有効化に cURL または allow_url_fopen が必要です。
オプション:intl 拡張機能
ヒジュラ暦(ウンム・アル=クラー暦)の日付で毎年繰り返すイベントでは、PHP の intl 拡張機能を使って毎年の日付を算出します。intl がない場合は次回の日付をご自身で入力する必要があり、必要なときにパネルがお知らせします。日付・毎年・ヒジュラ暦のイベントをスケジュールする をご覧ください。
Web サーバー
- Apache: Cardix は
.htaccessファイルでデータフォルダーを保護します。Cardix フォルダーで.htaccessファイルが許可されていること(AllowOverride All)を確認してください。 - Nginx: Nginx は
.htaccessファイルを読み込みません。インストール後、管理パネルがブラウザーからデータフォルダーが保護されているかを確認し、保護されていない場合はサーバー設定に追加する 2 行を表示します。Cardix をインストールする をご覧ください。 - HTTPS: Cardix は
https://cards.example.com/のような HTTPS アドレスで運用し、セットアップページも HTTPS で開いてください。
フォルダーとファイルの権限
インストール中、セットアップはパッケージ内の 2 つのフォルダー名を変更し、データフォルダーを作成し、Cardix フォルダーに config.php、.htaccess ファイル、.user.ini ファイルを書き込みます。ホスティングの PHP ユーザーが Cardix フォルダーに書き込める必要があります。
ホスティングが許可している場合、セットアップは Cardix フォルダーに次の PHP 制限も設定します(.user.ini に、mod_php を使う Apache では .htaccess にも):
| 設定 | 値 |
|---|---|
| upload_max_filesize | 32M |
| post_max_size | 40M |
| memory_limit | 256M |
| max_execution_time | 120 |
| max_input_time | 120 |
ブラウザー
管理者と参加者は、JavaScript を有効にした Web ブラウザーで Cardix を使用します。各カードのテキストはブラウザー上で描画されます。