Pancake Stack › Pancake Stack 매뉴얼
사이트 다루기
사이트 카드의 모든 것: 열기와 편집, PHP 버전과 캐시, 저장 지점, Git, PHP 설정, Xdebug, 스테이징 사본, Blueprint 등을 다룹니다.
4.1사이트 카드
사이트 패널의 각 사이트는 카드로 표시됩니다. 왼쪽 위의 표시등은 서버가 실행 중일 때 녹색입니다. 이름 옆에는 사이트의 종류(PHP, 정적, 또는 프레임워크가 함께 표시되는 Python)가, 그 아래에는 사이트의 주소가 있습니다.
- 열기
- 브라우저에서 사이트를 엽니다. 서버가 중지되어 있으면 회색으로 표시되므로 먼저 모두 시작을 클릭하십시오. 로컬 HTTPS를 켜면 자물쇠 버튼으로
https://주소를 열 수 있습니다. - 폴더 보기
- Finder에서 사이트의 폴더를 엽니다.
- 편집
- 편집기나 사이트 디자인 앱에서 사이트의 폴더를 엽니다(내 앱에서 편집 참조).
- 파일
- 내장 파일 브라우저, 편집기, 실시간 미리 보기를 엽니다. 파일, 편집기와 디자인을 참조하십시오.
- QR 코드
- 휴대폰이나 태블릿에서 사이트를 열 수 있는 코드를 보여 줍니다. 온라인일 때는 테스트 링크나 도메인을, 내 네트워크가 켜져 있을 때는 네트워크 이름을 엽니다.
- 저장 지점(시계)
- 언제든 되돌아갈 수 있는, 이름 붙인 사이트 사본입니다. 저장 지점을 참조하십시오.
카드가 좁으면 버튼이 아이콘으로 줄어듭니다. 포인터를 올리면 이름을 볼 수 있습니다.
4.2PHP 버전과 캐시
PHP 사이트에는 버튼 아래에 메뉴가 두 개 있습니다.
- 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 설정…은 이 사이트 하나의 PHP만 바꿉니다.
- 요청당 메모리, 최대 업로드, 요청당 시간 제한.
- 보고 범위: 전부(개발용), 사용 중단 경고를 뺀 전부, 오류와 경고, 오류만(운영용).
- 페이지에 오류 표시(그리고 표시하는 오류를 HTML 형식으로), 이 사이트의 PHP 로그에 오류 기록, 같은 줄에서 반복되는 오류 건너뛰기.
- 추가 php.ini 설정: 그 밖의 설정을 이름과 값으로 입력합니다.
기본값을 클릭하면 모두 원래대로 돌아갑니다. 모든 사이트의 PHP를 바꾸려면 php.ini 템플릿을 편집하십시오(템플릿 참조).
설정 ▸ 고급 ▸ 로그 크기 제한(10, 50, 200MB)을 넘은 로그는 최신 절반만 남기고 잘립니다.
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 사이트의 환경은 삭제됩니다. 데이터베이스는 데이터베이스 패널에 남아 있으므로, 그곳에서 내보내거나 삭제하십시오.