Pancake Stack › Pancake Stack マニュアル
サイトの操作
サイトカードでできることのすべて:開く・編集する、PHP のバージョンとキャッシュ、保存ポイント、Git、PHP 設定、Xdebug、ステージング用コピー、Blueprint など。
4.1サイトカード
サイトペインでは、各サイトが 1 枚のカードになっています。左上のランプはサーバが動いている間は緑色です。名前の横にはサイトの種類(PHP、静的、または Python とそのフレームワーク)が、その下にはサイトのアドレスが表示されます。
- 開く
- ブラウザでサイトを開きます。サーバが止まっている間は灰色表示なので、先に「すべて開始」をクリックしてください。ローカル HTTPS をオンにすると、
https://のアドレスを開く鍵のボタンが加わります。 - フォルダを表示
- サイトのフォルダを Finder で開きます。
- 編集
- サイトのフォルダを自分のエディタやサイト制作アプリで開きます(自分のアプリで編集をご覧ください)。
- ファイル
- 内蔵のファイルブラウザ、エディタ、ライブプレビューを開きます。ファイル、エディタ、デザインをご覧ください。
- QR コード
- スマートフォンやタブレットでサイトを開くためのコードを表示します。オンラインのときはテストリンクかドメイン、自分のネットワークがオンのときはネットワーク上の名前です。
- 保存ポイント(時計)
- あとで戻れる、名前付きのサイトのコピーです。保存ポイントをご覧ください。
カードの幅が狭いときはボタンがアイコンだけになります。ポインタを重ねると名前が表示されます。
4.2PHP のバージョンとキャッシュ
PHP サイトでは、ボタンの下に 2 つのメニューがあります。
- PHP のバージョン。どのプランでも最新の PHP(8.5)で動きます。FullStack では、サイトごとに古いバージョン(古いコード用の 8.4、8.3、8.2、7.1)を選べます。切り替える前に Pancake が「Before PHP 8.4 (was 8.5)」という名前の保存ポイントを作るので、ワンクリックで元に戻せます。
- キャッシュ。キャッシュなし、OPcache(コンパイル済みの PHP をメモリに保持します。高速で、ホスティングでも使われている方式です)、OPcache + APCu(WordPress などのアプリがデータの保存に使えるメモリキャッシュを追加します)。
FullStack で古い PHP に設定したサイトは、プランが変わると最新の PHP で動き、選択はあとのために残ります。カードにその旨が表示され、最新のバージョンに完全に切り替えるボタンも表示されます。
4.3AutoIndex
AutoIndex(index ページのないフォルダを一覧表示)をオンにすると、index.html や index.php のないフォルダを開いたときにファイルの一覧を表示します。ダウンロード用のファイルや書類を入れたフォルダに便利です。隠しファイルや機密ファイル(.env、.sql のダンプ、鍵、.htpasswd など)は、AutoIndex のオン・オフにかかわらず、一覧にも配信にも出ません。
4.4保存ポイント
保存ポイントは、ワンクリックで戻れるサイトのファイルとデータベースのコピーです。「WordPress 更新前」のように名前を付けます。
- サイトのカードの時計ボタンをクリックし、保存ポイントを作成…を選びます。
- 名前を付けて保存をクリックします。
- 戻すときは、同じメニューを開いて保存ポイントを選び、復元を選びます。
元に戻しにくい変更の前にも、Pancake が自動で保存ポイントを作ります。PHP バージョンの切り替え、バックアップの復元、新しいデザインの採用、画像の最適化、アシスタントによるファイルの変更、公開中のサイトの再ダウンロード、Pancake Cloud からのサイトの読み込みの前です。各サイトは最新 20 個の保存ポイントを、通常のバックアップとは別に保管します(バックアップと保存ポイントをご覧ください)。
4.5自分のアプリで編集
編集ボタンは、設定 ▸ エディタ ▸ サイトの編集に使うアプリで選んだアプリでサイトのフォルダを開きます。BBEdit、VS Code、Nova、Cursor、Zed などのコードエディタや、RapidWeaver、Blocs、Hype などのサイト制作アプリを選べます。macOS がファイルごとに選ぶアプリを選ぶと、ファイルをそれぞれの既定のアプリで開きます。
サイトごとにアプリを選ぶこともできます。「詳細」をオンにして、カードのこのサイトの編集に使うアプリを使います。
4.6Python のサイト
Python のカードには、PHP のメニューの代わりに専用のボタンがあります。
- 設定は、サイトの Python 環境を作ってフレームワークをインストールします(一度実行するまで表示されます)。
- 必要なパッケージをインストールは、サイトの
requirements.txtにあるパッケージをインストールします。 - Django のサイトにはマイグレート、静的ファイルを収集、スーパーユーザ…が加わります。
「詳細」をオンにすると、Python のバージョン(3.12、3.13、3.14。変えると環境を作り直します)、アプリのエントリ、コードが変わったら再読み込み、ワーカの数(1〜8)、アプリのログと設定のログ、環境を作り直す…、Django では確認を実行も使えます。
4.7カードの詳細設定
サイトペインのヘッダで詳細をオンにすると、すべてのカードに項目が増えます。
- Git
- 後述の Git をご覧ください。
- エイリアス
- 同じサイトの別名を、
www.shop.localhostのようにコンマで区切って指定します。エイリアスは.localhostで終わる必要があります。 - PHP 設定…
- PHP 設定をご覧ください。
- Apache ディレクティブ…
- このサイトの Apache の
<VirtualHost>内に追加する行です。ホスティングで設定できるようなリライトルールやヘッダに使います。Pancake は先に Apache で確認し、読み込めない場合はその行を使わずにエラーを表示するので、入力ミスでほかのサイトが止まることはありません。 - ログ
- ログウインドウで、このサイトの PHP エラーを開きます。
- Xdebug
- オフ、トリガ時(ブラウザ拡張機能か
XDEBUG_TRIGGERで起動)、すべてのリクエストから選びます。エディタ(VS Code、PhpStorm、Nova)はポート 9003 で待ち受けます。サイトはデバッグ用の専用 PHP プロセスで動くので、ほかのサイトは遅くなりません。 - データベース
- Pancake のものか、登録した外部のデータベースのいずれかです。どちらの場合も、サイトにはそのデータベースの
DB_HOST、DB_PORT、DB_NAME、DB_USER、DB_PASSWORDが渡されます。 - ウェブサーバ
- Apache か Nginx FullStack です。Nginx では Nginx のホストと同じく
try_filesでルーティングし、.htaccessは使いません。最初に応答するのは引き続き Apache で(HTTPS、トンネル、ローカル限定のルールのため)、サイトへのリクエストを Nginx に渡します。 - シングルページアプリ
- 静的サイトのみ。ファイルではないアドレスはすべて
index.htmlを開くので、Vite、Lovable、React のアプリで/aboutのようなルートを直接開いたり再読み込みしたりしても動きます。 - 実際にメールを送信
- TallStack このサイトのメールを受け止めると同時に、SMTP リレーで実際に送信します。メールリレーをご覧ください。
- 環境変数…
- TallStack 自分で設定する環境変数です。環境変数をご覧ください。
- 画像を最適化…
- 画像の最適化をご覧ください。
- Blueprint として保存…
- Blueprint をご覧ください。
- ステージング用のコピーを作成…
- TallStack ステージング用コピーをご覧ください。
- サイトを削除…
- サイトの削除をご覧ください。
4.8PHP 設定
PHP 設定…は、1 つのサイトだけの PHP の設定を変えます。
- リクエストごとのメモリ、最大アップロードサイズ、リクエストごとの時間制限。
- 報告する内容:すべて(開発用)、非推奨以外すべて、エラーと警告、エラーのみ(本番用)。
- エラーをページに表示(と表示するエラーを HTML 形式にする)、このサイトの PHP ログにエラーを書き込む、同じ行で繰り返すエラーを省略。
- その他の php.ini 設定:そのほかの設定を名前と値で指定します。
既定値ですべて元に戻ります。すべてのサイトの PHP を変えるには、php.ini のテンプレートを編集します(テンプレートをご覧ください)。
設定 ▸ 詳細 ▸ ログの上限(10、50、200 MB)を超えたログは、新しい半分だけに切り詰めます。
4.9環境変数
TallStack 環境変数…には、API キーや APP_ENV=local のような、サイト独自の設定や秘密の情報を保存します。
- 追加をクリックして名前と値を入力するか、.env から貼り付け…で
.envファイルをまとめて取り込みます。 - 保存をクリックします。PHP と Python が値を読み込めるよう、Pancake がサーバを再起動します。
値はサイトのフォルダではなくキーチェーンに保存され、サイトのスケジュールタスクとワーカにも渡されます。Pancake 自身が設定する名前(DB_…、PANCAKE_…、DATABASE_URL、PATH、HOME など)は予約されており、Pancake の値が優先されます。
4.10Git
Pancake には Git が内蔵されているので、Xcode のコマンドラインツールは要りません。
- リポジトリではないサイトにはGit を開始が表示されます。
- リポジトリでは、ブランチ、変更したファイルの数、リモートより進んでいるか遅れているかが表示され、コミット…、プル、プッシュ(またはリモートを追加する接続…)を使えます。
- 「詳細」をオンにすると、リモートのアドレス、リモートを変更…、ブランチメニュー、ブランチを作る欄、直近 8 件のコミットも表示されます。
Pancake の .gitignore は、.env ファイル、SQL のダンプ、依存フォルダ、キャッシュをコミットから除外します。コミットに使う名前とメール、Git ホスト用の個人アクセストークンや Pancake の SSH キーは、設定 ▸ Git(詳細)で設定します。
4.11画像の最適化
画像を最適化…は、サイトの JPEG と PNG のファイルを小さくします。
- ロスレス — 画素はそのままでファイルを小さくまたはより小さく — 高画質 JPEG(品質 82)。
- 位置情報とカメラ情報を削除は、写真から GPS とカメラのデータを取り除きます。
- 最大サイズは、大きな画像を縮小します(3840、2560、1920、1280 ピクセル)。サイズをそのままにすることもできます。
- 先に保存ポイントを作るは既定でオンです。
結果が小さくなったときだけファイルを置き換えます。依存フォルダ(vendor、node_modules)と WordPress 本体のファイルには触れません。既定の設定は設定 ▸ 画像で決めます。
4.12Blueprint
Blueprint は、ファイル、データベース、設定ごとテンプレートとして保存したサイトです。顧客ごとのサイトを毎回同じテーマとプラグインから始めるときに使います。
- サイトのカード(詳細)でBlueprint として保存…を選び、名前を付けて保存をクリックします。サーバが止まっているときは、ファイルだけが保存されます。
- 使うときは新規サイト ▸ ブループリントからを選び、Blueprint を選んで新しい名前を入力し、作成をクリックします。
4.13ステージング用コピー
TallStack ステージング用のコピーを作成…は、専用のフォルダとデータベースを持つ別のサイトを作ります。名前は、別の名前を選ばなければ <site>-staging になります。サイト内のアドレスはコピー自身の .localhost の名前に書き換えられるので、元のサイトには影響しません。危険な更新は、まずコピーで試してください。
4.14サイトの削除
サイトを削除…(詳細)は、サイトを Pancake から削除し、フォルダをゴミ箱に移します。ファイルはあとから取り戻せます。Python のサイトの環境は削除されます。データベースはデータベースペインに残るので、そこで書き出すか削除してください。