สำหรับ CAMPP v0.3.14

คู่มือการใช้งาน CAMPP

ทุกอย่างที่คุณต้องรู้เพื่อรันเว็บไซต์ PHP และฐานข้อมูลบนเครื่องของคุณเองด้วย CAMPP

ติดตั้ง CAMPP

CAMPP คือชุดเครื่องมือพัฒนาเว็บบนเครื่อง (local) ที่รวม Caddy (เว็บเซิร์ฟเวอร์), PHP, MySQL หรือ MariaDB, PostgreSQL, phpMyAdmin และ Adminer ไว้ในแอปเดียว ทำงานจากโฟลเดอร์ผู้ใช้ของคุณเอง จึงไม่ต้องใช้สิทธิ์ผู้ดูแลระบบ (admin)

  • Windows: CAMPP-x64.exe (แนะนำ) หรือ .msi ไฟล์ .zip แบบพกพา (portable) รันได้เลยโดยไม่ต้องติดตั้ง ส่วนรุ่น offline มีรันไทม์ครบทุกตัวในตัวแล้ว
  • 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 ได้รับการเซ็นและผ่านการรับรอง (notarize) จาก Apple แล้ว

การเปิดใช้งานครั้งแรก

เมื่อเปิด CAMPP ครั้งแรก จะมีตัวช่วยตั้งค่าสั้น ๆ ที่ดาวน์โหลดรันไทม์ที่คุณเลือก

  1. คลิก Get Started ที่หน้าต้อนรับ
  2. เลือกคอมโพเนนต์ที่ต้องการและเลือกเวอร์ชันของแต่ละตัว โดย Caddy และ PHP จำเป็นต้องมี
  3. ในหน้าเดียวกัน ตั้งรหัสผ่าน root ให้กับฐานข้อมูลแต่ละตัวที่ติดตั้ง (MySQL/MariaDB และ PostgreSQL) อย่าลืมจดไว้ เพราะต้องใช้รหัสนี้เข้าสู่ระบบฐานข้อมูล
  4. คลิก Download & Install แล้ว CAMPP จะดาวน์โหลดและตั้งค่าทุกอย่างให้
  5. เมื่อเสร็จแล้ว คลิก Continue to Dashboard
บน Linux หากตัวช่วยตั้งค่าแจ้งว่ายังขาดแพ็กเกจระบบ ให้ติดตั้งด้วย package manager ของคุณ แล้วคลิก Retry Check

เริ่มและหยุดเซอร์วิส

Services: แต่ละแถวแสดงเวอร์ชัน พอร์ต และสถานะ พร้อมสวิตช์สำหรับเริ่มหรือหยุดการทำงาน

หน้า Services แสดงรายการเซอร์วิสทั้งหมดที่ติดตั้งไว้ ใช้สวิตช์ในแต่ละแถวเพื่อเริ่มหรือหยุด ใช้ปุ่มลูกศรวงกลมเพื่อรีสตาร์ต หรือใช้ Start all / Stop all ที่ด้านบน

การ์ดด้านล่างรายการใช้เปิด Website, phpMyAdmin, Adminer หรือ Projects folder ของคุณ โดยสามอันแรกต้องให้ Caddy ทำงานอยู่

เซอร์วิสพอร์ตเริ่มต้นที่อยู่
เว็บเซิร์ฟเวอร์ (Caddy)8080http://localhost:8080
PHP-FPM9000ใช้ภายใน โดย Caddy
MySQL / MariaDB3307127.0.0.1:3307
PostgreSQL5433127.0.0.1:5433
CAMPP ใช้พอร์ตที่ไม่ใช่ค่ามาตรฐานเหล่านี้ เพื่อให้รันควบคู่กับ MySQL หรือ PostgreSQL ที่คุณอาจติดตั้งไว้แล้วได้

โปรเจกต์ของคุณ

วางเว็บไซต์แต่ละเว็บไว้ในโฟลเดอร์ของตัวเองภายในโฟลเดอร์ projects หากต้องการเปิดโฟลเดอร์นี้ ให้คลิกการ์ด Projects folder ในหน้า Services

projects/
├── my-site/
│   ├── index.php
│   └── style.css
└── shop/
    └── index.html
  • http://localhost:8080/my-site/ จะรัน my-site/index.php
  • โฟลเดอร์ที่มี index.html จะถูกเสิร์ฟเป็นเว็บไซต์แบบ static
  • หน้าที่ไม่มีอยู่ หรือโฟลเดอร์ที่ไม่มี index.php หรือ index.html จะแสดง 404 Not Found ให้ลิงก์ไปที่ไฟล์โดยตรง เช่น /my-site/report.php
http://localhost:8080 จะแสดงหน้าต้อนรับของ CAMPP พร้อมเวอร์ชัน PHP และลิงก์ลัด

ฐานข้อมูล

การตั้งค่าMySQL / MariaDBPostgreSQL
Host127.0.0.1127.0.0.1
พอร์ต33075433
ผู้ใช้rootroot
รหัสผ่านรหัสผ่าน 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 ให้ใช้ 127.0.0.1 แทน localhost เพราะถ้าใช้ localhost PHP จะพยายามเชื่อมต่อผ่าน local socket แทนพอร์ต TCP
phpMyAdmin (http://localhost:8080/phpmyadmin): เข้าสู่ระบบด้วยผู้ใช้ root และรหัสผ่านฐานข้อมูลของคุณ
Adminer (http://localhost:8080/adminer): เลือก MySQL หรือ PostgreSQL แล้วพิมพ์รหัสผ่านฐานข้อมูลของคุณ

phpMyAdmin และ Adminer จะถามรหัสผ่านทุกครั้ง เพื่อให้ฐานข้อมูลของคุณปลอดภัยเมื่อแชร์เว็บไซต์ในเครือข่าย

คอมโพเนนต์

Components: ติดตั้ง ติดตั้งใหม่ หรือลบซอฟต์แวร์ที่ CAMPP ใช้งาน

หน้า Components แสดงคอมโพเนนต์แต่ละตัวพร้อมเวอร์ชันที่ติดตั้งอยู่ Install ใช้ติดตั้งตัวที่ยังไม่มี Uninstall ใช้ลบออก และ Reinstall ให้คุณเลือกเวอร์ชันอื่นได้

Reinstall: เลือกเวอร์ชัน แล้วคลิก Reinstall
หากต้องการอัปเดตแพตช์ความปลอดภัยล่าสุดของ PHP ให้เปิด Components → PHP → Reinstall แล้วเลือกเวอร์ชันที่มีป้าย Latest
หยุดเซอร์วิสทั้งหมดก่อนติดตั้ง ติดตั้งใหม่ หรือลบคอมโพเนนต์

การตั้งค่า

Settings: การเปลี่ยนแปลงจะมีผลในครั้งถัดไปที่เริ่มเซอร์วิส
  • Network: Local only (ค่าเริ่มต้น) หมายถึงเปิดเว็บไซต์ได้จากเครื่องนี้เท่านั้น ส่วน LAN ให้อุปกรณ์อื่นในเครือข่ายเดียวกันเข้าถึงได้
  • Ports: เปลี่ยนพอร์ตได้หากมีโปรแกรมอื่นใช้พอร์ตนั้นอยู่แล้ว
  • Database passwords: พิมพ์รหัสผ่าน root ใหม่ หรือเว้นว่างไว้เพื่อใช้รหัสผ่านเดิม ระบบจะไม่แสดงรหัสผ่านปัจจุบันให้เห็น
  • Delete all projects and databases: ล้างโฟลเดอร์ projects และลบฐานข้อมูลทั้งหมด โดยไม่มีการสำรองข้อมูลให้ จึงควรสำรองข้อมูลก่อน
เปลี่ยนการตั้งค่าได้เฉพาะตอนที่หยุดเซอร์วิสทั้งหมดแล้วเท่านั้น ส่วนธีม (System, Light, Dark) สลับได้ทุกเมื่อจากไอคอนด้านล่างของแถบด้านข้าง

สำรองและกู้คืนข้อมูล

Backup: ไฟล์ zip เดียวที่รวมโปรเจกต์และข้อมูลฐานข้อมูลทั้งหมดของคุณ
  1. คลิก Stop all ในหน้า Services
  2. เปิดหน้า Backup แล้วคลิก Back up now ไฟล์ zip จะปรากฏในรายการ
  3. หากต้องการย้อนกลับไปใช้ข้อมูลสำรอง ให้คลิก Restore โดย CAMPP จะบันทึกสถานะปัจจุบันไว้ก่อน (มีป้าย before restore) จึงยกเลิกการกู้คืนได้
  4. คลิก Delete เพื่อลบข้อมูลสำรองที่ไม่ต้องการแล้ว
Open folder จะแสดงตำแหน่งที่เก็บข้อมูลสำรอง หากต้องการย้ายไปเครื่องอื่น ให้คัดลอกไฟล์ zip ไปไว้ในโฟลเดอร์ backups ของเครื่องนั้น
ข้อมูลฐานข้อมูลกู้คืนได้เฉพาะบนระบบปฏิบัติการเดียวกันเท่านั้น (Windows, macOS หรือ Linux) หากต้องการย้ายฐานข้อมูลข้ามระบบ ให้ export ด้วย phpMyAdmin หรือ Adminer แล้ว import ในเครื่องปลายทาง

แชร์กับอุปกรณ์อื่น

โดยค่าเริ่มต้น CAMPP จะรับการเชื่อมต่อเฉพาะที่ 127.0.0.1 เท่านั้น จึงไม่มีใครอื่นเข้าถึงเว็บไซต์หรือฐานข้อมูลของคุณได้

  • โหมด LAN (Settings → Network) ให้โทรศัพท์และคอมพิวเตอร์เครื่องอื่นในเครือข่ายเดียวกันเปิดเว็บไซต์ของคุณได้ เช่น http://192.168.1.20:8080
  • ngrok (Windows) ให้ที่อยู่สาธารณะบนอินเทอร์เน็ตกับเว็บไซต์ของคุณ ติดตั้ง ngrok ในหน้า Components วาง authtoken จาก ngrok.com ในหน้า Settings แล้วเริ่ม ngrok ในหน้า Services
ใช้โหมด LAN และ ngrok เฉพาะในเครือข่ายที่ไว้ใจได้ และตั้งรหัสผ่านฐานข้อมูลให้รัดกุม หน้า Settings จะเตือนเมื่อรหัสผ่านไม่ปลอดภัยขณะเปิดโหมด LAN

การแก้ปัญหา

Debug: เวอร์ชัน โฟลเดอร์ การตรวจสอบพอร์ต และการรีเซ็ตทั้งหมด
  • เซอร์วิสไม่ยอมเริ่มทำงาน: เปิด Debug → Port check หากพอร์ตขึ้นว่า In Use แสดงว่ามีโปรแกรมอื่นใช้อยู่ ให้เปลี่ยนพอร์ตใน Settings
  • เข้าสู่ระบบ phpMyAdmin หรือ Adminer ไม่ได้: ใช้ root กับรหัสผ่านฐานข้อมูล หรือตั้งรหัสผ่านใหม่ที่ Settings → Database passwords
  • ต้องการความช่วยเหลือ: คลิก Copy diagnostics แล้ววางผลลัพธ์ลงใน GitHub issue
  • เริ่มต้นใหม่ทั้งหมด: Reset installation จะลบรันไทม์ ฐานข้อมูล และการตั้งค่า แต่โฟลเดอร์ projects และข้อมูลสำรองของคุณจะยังอยู่

CAMPP เก็บไฟล์ของคุณไว้ที่ไหน

ระบบตำแหน่ง
Windowsโฟลเดอร์ที่ติดตั้ง CAMPP (ค่าเริ่มต้นคือ %LOCALAPPDATA%\CAMPP) หรือโฟลเดอร์ที่คุณแตกไฟล์เวอร์ชันพกพาไว้
macOS~/Library/Application Support/campp
Linux~/.local/share/campp

ภายในประกอบด้วย projects (เว็บไซต์ของคุณ), mysql/data และ pgsql/data (ฐานข้อมูล), backups, logs และ runtime (โปรแกรมที่ดาวน์โหลดมา) ดูพาธที่แน่นอนบนเครื่องของคุณได้ที่ Debug → Folders

ภาพหน้าจอจะเปลี่ยนตามธีมสว่างหรือมืดของเว็บไซต์นี้

คู่มือการใช้งาน | CAMPP