사용자 매뉴얼

CAMPP 설치

CAMPP는 Caddy(웹 서버), PHP, MySQL 또는 MariaDB, PostgreSQL, phpMyAdmin, Adminer를 하나의 앱에 담은 로컬 웹 개발 스택입니다. 사용자 폴더에서 실행되므로 관리자 권한이 필요 없습니다.

Windows: CAMPP-x64.exe(권장) 또는 .msi. 포터블 .zip 파일은 설치 없이 실행되며, 오프라인 버전에는 모든 런타임이 이미 포함되어 있습니다.
macOS: universal.dmg는 Apple Silicon과 Intel 모두에서 동작합니다. 파일을 열고 CAMPP를 Applications로 드래그하세요.
Linux: .deb(Ubuntu/Debian), .rpm(Fedora/openSUSE), .AppImage 또는 포터블 .tar.gz.

Windows에서는 SmartScreen이 알 수 없는 앱이라고 경고할 수 있습니다. More info를 클릭한 다음 Run anyway를 클릭하세요. macOS 빌드는 Apple의 서명 및 공증을 받았습니다.

처음 실행하기

CAMPP를 처음 열면 간단한 설정 마법사가 선택한 런타임을 다운로드합니다.

환영 화면에서 Get Started를 클릭합니다.
원하는 컴포넌트를 선택하고 각각의 버전을 고릅니다. Caddy와 PHP는 필수입니다.
같은 화면에서 설치할 각 데이터베이스(MySQL/MariaDB 및 PostgreSQL)의 root 비밀번호를 설정합니다. 데이터베이스에 로그인할 때 사용하므로 꼭 기억해 두세요.
Download & Install을 클릭합니다. CAMPP가 모든 것을 다운로드하고 설정합니다.
완료되면 Continue to Dashboard를 클릭합니다.

Linux에서 마법사가 누락된 시스템 패키지를 표시하면 패키지 관리자로 설치한 뒤 Retry Check를 클릭하세요.

서비스 시작 및 중지

Caddy, PHP-FPM, MySQL, PostgreSQL이 실행 중인 CAMPP Services 페이지 — Services: 각 행에 버전, 포트, 상태가 표시되며, 스위치로 시작하거나 중지할 수 있습니다.

Services 페이지에는 설치된 모든 서비스가 표시됩니다. 각 행의 스위치로 서비스를 시작하거나 중지하고, 둥근 화살표로 재시작하거나, 상단의 Start all / Stop all을 사용하세요.

목록 아래의 카드를 클릭하면 Website, phpMyAdmin, Adminer 또는 Projects folder가 열립니다. 처음 세 가지는 Caddy가 실행 중이어야 합니다.

서비스	기본 포트	주소
웹 서버 (Caddy)	8080	`http://localhost:8080`
PHP-FPM	9000	내부용, Caddy가 사용
MySQL / MariaDB	3307	`127.0.0.1:3307`
PostgreSQL	5433	`127.0.0.1:5433`

CAMPP는 이미 설치되어 있을 수 있는 MySQL이나 PostgreSQL과 함께 실행할 수 있도록 이러한 비표준 포트를 사용합니다.

프로젝트

각 웹사이트를 프로젝트 폴더 안의 별도 폴더에 넣으세요. 폴더를 열려면 Services 페이지에서 Projects folder 카드를 클릭합니다.

projects/
├── my-site/
│   ├── index.php
│   └── style.css
└── shop/
    └── index.html

http://localhost:8080/my-site/는 my-site/index.php를 실행합니다.
index.html이 있는 폴더는 정적 사이트로 제공됩니다.
존재하지 않는 페이지나 index.php 또는 index.html이 없는 폴더는 404 Not Found를 표시합니다. 이 경우 /my-site/report.php처럼 파일에 직접 링크하세요.

PHP 및 Caddy 버전과 PHP info, phpMyAdmin, Adminer 링크를 보여 주는 CAMPP 환영 페이지 — http://localhost:8080에서는 PHP 버전과 바로가기 링크가 있는 CAMPP 환영 페이지가 표시됩니다.

데이터베이스

설정	MySQL / MariaDB	PostgreSQL
호스트	`127.0.0.1`	`127.0.0.1`
포트	`3307`	`5433`
사용자	`root`	`root`
비밀번호	설정 중에 지정한 root 비밀번호	설정 중에 지정한 root 비밀번호

PHP에서 PDO로 연결합니다:

<?php
$mysql = new PDO('mysql:host=127.0.0.1;port=3307;dbname=test;charset=utf8mb4', 'root', 'your-password');
$pgsql = new PDO('pgsql:host=127.0.0.1;port=5433;dbname=postgres', 'root', 'your-password');

MySQL에는 localhost 대신 127.0.0.1을 사용하세요. localhost를 사용하면 PHP가 TCP 포트 대신 로컬 소켓으로 연결을 시도합니다.

phpMyAdmin 로그인 페이지 — phpMyAdmin (http://localhost:8080/phpmyadmin): root와 데이터베이스 비밀번호로 로그인합니다.

MySQL 및 PostgreSQL 로그인 버튼이 있는 CAMPP Adminer 실행 화면 — Adminer (http://localhost:8080/adminer): MySQL 또는 PostgreSQL을 선택한 다음 데이터베이스 비밀번호를 입력합니다.

phpMyAdmin과 Adminer는 항상 비밀번호를 요구합니다. 네트워크에 사이트를 공유하더라도 데이터베이스를 안전하게 보호하기 위함입니다.

컴포넌트

Caddy, PHP, MySQL, phpMyAdmin, PostgreSQL, Adminer, ngrok이 나열된 Components 페이지 — Components: CAMPP가 실행하는 소프트웨어를 설치, 재설치 또는 제거합니다.

Components 페이지에는 각 컴포넌트와 설치된 버전이 표시됩니다. Install은 없는 컴포넌트를 추가하고, Uninstall은 제거하며, Reinstall로 다른 버전을 선택할 수 있습니다.

버전 선택기가 있는 Reinstall PHP 대화 상자 — Reinstall: 버전을 선택한 다음 Reinstall을 클릭합니다.

PHP의 최신 보안 수정 사항을 적용하려면 Components → PHP → Reinstall을 열고 Latest로 표시된 버전을 선택하세요.

컴포넌트를 설치, 재설치 또는 제거하기 전에 모든 서비스를 중지하세요.

설정

Network, Ports, Database passwords 및 위험 영역이 있는 Settings 페이지 — Settings: 변경 사항은 다음에 서비스를 시작할 때 적용됩니다.

Network: Local only(기본값)는 이 컴퓨터에서만 사이트를 열 수 있음을 의미합니다. LAN을 선택하면 같은 네트워크의 다른 기기에서도 접속할 수 있습니다.
Ports: 다른 프로그램이 이미 포트를 사용 중이면 포트를 변경하세요.
Database passwords: 새 root 비밀번호를 입력하거나, 현재 비밀번호를 유지하려면 비워 두세요. 현재 비밀번호는 표시되지 않습니다.
Delete all projects and databases: 프로젝트 폴더를 비우고 모든 데이터베이스를 삭제합니다. 백업이 만들어지지 않으므로 먼저 백업하세요.

설정은 모든 서비스가 중지된 상태에서만 변경할 수 있습니다. 테마(System, Light, Dark)는 사이드바 하단의 아이콘으로 언제든지 전환할 수 있습니다.

백업 및 복원

Open folder 및 Back up now 버튼이 있는 Backup 페이지 — Backup: 프로젝트와 모든 데이터베이스 데이터를 하나의 zip으로 저장합니다.

Services 페이지에서 Stop all을 클릭합니다.
Backup을 열고 Back up now를 클릭합니다. 목록에 zip 파일이 나타납니다.
백업 시점으로 되돌리려면 Restore를 클릭합니다. CAMPP는 먼저 현재 상태를 저장하므로(before restore로 표시) 복원을 취소할 수 있습니다.
더 이상 필요 없는 백업은 Delete를 클릭해 삭제합니다.

Open folder를 클릭하면 백업이 저장된 위치가 표시됩니다. 다른 컴퓨터로 옮기려면 zip 파일을 해당 컴퓨터의 backups 폴더에 복사하세요.

데이터베이스 데이터는 같은 운영 체제(Windows, macOS 또는 Linux)에서만 복원할 수 있습니다. 서로 다른 시스템 간에 데이터베이스를 옮기려면 phpMyAdmin이나 Adminer로 내보낸 뒤 다른 컴퓨터에서 가져오세요.

다른 기기와 공유하기

기본적으로 CAMPP는 127.0.0.1에서만 응답하므로 다른 사람은 사이트나 데이터베이스에 접근할 수 없습니다.

LAN 모드(Settings → Network)를 사용하면 같은 네트워크의 휴대폰이나 다른 컴퓨터에서 http://192.168.1.20:8080과 같은 주소로 사이트를 열 수 있습니다.
ngrok(Windows)은 사이트에 공개 인터넷 주소를 부여합니다. Components 페이지에서 ngrok을 설치하고, ngrok.com에서 받은 authtoken을 Settings에 붙여 넣은 다음, Services 페이지에서 ngrok을 시작하세요.

LAN 모드와 ngrok은 신뢰할 수 있는 네트워크에서만 사용하고, 강력한 데이터베이스 비밀번호를 설정하세요. LAN 모드가 켜져 있을 때 비밀번호가 약하면 Settings에서 경고를 표시합니다.

문제 해결

시스템 정보, 폴더, 포트 확인 및 초기화가 있는 Debug 페이지 — Debug: 버전, 폴더, 포트 확인 및 전체 초기화.

서비스가 시작되지 않는 경우: Debug → Port check를 엽니다. 포트가 In Use로 표시되면 다른 프로그램이 사용 중이므로 Settings에서 포트를 변경하세요.
phpMyAdmin 또는 Adminer에 로그인할 수 없는 경우: root와 데이터베이스 비밀번호를 사용하세요. 새 비밀번호는 Settings → Database passwords에서 설정할 수 있습니다.
도움이 필요한 경우: Copy diagnostics를 클릭하고 결과를 GitHub 이슈에 붙여 넣으세요.
처음부터 다시 시작하려는 경우: Reset installation은 런타임, 데이터베이스, 설정을 삭제합니다. 프로젝트 폴더와 백업은 유지됩니다.

CAMPP 파일 저장 위치

시스템	위치
Windows	CAMPP가 설치된 폴더(기본값 `%LOCALAPPDATA%\CAMPP`) 또는 포터블 버전의 압축을 푼 위치
macOS	`~/Library/Application Support/campp`
Linux	`~/.local/share/campp`

그 안에는 projects(사이트), mysql/data 및 pgsql/data(데이터베이스), backups, logs, runtime(다운로드한 프로그램)이 있습니다. Debug → Folders에서 내 컴퓨터의 정확한 경로를 확인할 수 있습니다.