🐘
PHP 치트시트

PHP 8.2/8.3 모던 문법, Composer, Nullsafe(?->), Match 표현식, 생성자 프로퍼티 승격, PDO 안전한 쿼리, 슈퍼글로벌 및 실무 보안 레퍼런스
#php#php8#backend#composer#web#oop#laravel#pdo최종 업데이트: 2026-09-27
PHP 치트시트 핵심 명령어 및 실전 가이드

PHP 8.2/8.3 모던 문법, Composer, Nullsafe(?->), Match 표현식, 생성자 프로퍼티 승격, PDO 안전한 쿼리, 슈퍼글로벌 및 실무 보안 레퍼런스
## 1. PHP 8.x 설치 & 내장 웹 서버 (Setup & Built-in Server)
```bash
# 🐘 [1] OS별 PHP 8.x 최신 버전 설치
# macOS (Homebrew)
brew install php
# Ubuntu / Debian (Ondřej Surý PPA 권장)
sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install -y php8.3 php8.3-cli php8.3-fpm php8.3-mysql php8.3-xml php8.3-curl php8.3-mbstring

# 🪟 Windows (winget)
winget install PHP.PHP.8.3

# [2] 설치 및 모듈 확인
php -v
php -m # 설치된 확장 모듈 목록

# [3] 개발용 로컬 내장 웹 서버 즉시 실행 (포트 8000)
# 현재 디렉토리 기준
php -S localhost:8000
# 특정 public 디렉토리를 루트로 지정 실행
php -S localhost:8000 -t public
```

## 2. 모던 PHP 8.x 신기능 (PHP 8.0 ~ 8.3 Modern Features)
```php
<?php
// [1] Nullsafe 연산자 (?->) - 중간 객체가 null이어도 에러 없이 null 반환
$country = $session?->user?->getAddress()?->country;

// [2] Match 표현식 (Switch 문 대체, 엄격한 === 비교 및 값 반환)
$status = match ($statusCode) {
    200, 201 => '성공',
    400, 404 => '클라이언트 오류',
    500 => '서버 오류',
    default => '알 수 없음',
};

// [3] 생성자 프로퍼티 승격 (Constructor Property Promotion)
// 필드 선언, 매개변수 선언, 할당을 생성자 인자에서 한 번에 처리
class User {
    public function __construct(
        public readonly int $id,           // readonly: 생성 후 변경 불가
        public string $name,
        public string $email = '',
        private ?string $password = null,
    ) {}
}

// [4] 명명된 인수 (Named Arguments)
// 순서에 구애받지 않고 원하는 매개변수만 명시적으로 전달
$user = new User(id: 1, name: 'Lucky', email: 'lucky@test.com');

// [5] Enum (열거형 - PHP 8.1+)
enum UserRole: string {
    case Admin = 'ADMIN';
    case Manager = 'MANAGER';
    case Guest = 'GUEST';
}
```

## 3. 변수, 데이터 타입 & 연산자 (Variables & Operators)
```php
<?php
// [1] 엄격한 타입 모드 선언 (파일 최상단 필수 권장)
declare(strict_types=1);

$name = "Lucky";
$age = 28;
$isMember = true;
$pi = 3.14159;

// [2] 널 병합 연산자 (?? 및 ??=)
// 변수가 존재하지 않거나 null이면 기본값 사용
$username = $_GET['user'] ?? 'Guest';
// 널 병합 할당: 변수가 null일 때만 값 할당
$config['timeout'] ??= 30;

// [3] 삼항 연산자 단축
$result = $isValid ?: '실패'; // $isValid ? $isValid : '실패'

// [4] 우주선 연산자 (<=>) - 두 값 비교 (-1, 0, 1 반환)
// 정렬 콜백 함수 작성 시 매우 편리
usort($items, fn($a, $b) => $a['price'] <=> $b['price']);

// [5] 엄격한 비교 (===) 원칙
// == (타입 변환 느슨한 비교: 0 == "0" -> true)
// === (타입과 값이 모두 일치: 0 === "0" -> false)
```

## 4. 배열 다루기 (Arrays: Indexed & Associative)
```php
<?php
// [1] 인덱스 배열 & 연관 배열
$fruits = ['apple', 'banana', 'cherry'];
$user = [
    'id' => 10,
    'name' => 'Lucky',
    'roles' => ['admin', 'editor']
];

// [2] 배열 구조 분해 할당 (Destructuring) & Spread 연산자 (...)
[$first, $second] = $fruits;
$allFruits = ['mango', ...$fruits]; // ['mango', 'apple', 'banana', 'cherry']

// [3] 실무 필수 내장 배열 함수
// 1. 값 존재 여부 검사
if (in_array('apple', $fruits, true)) { /* ... */ }
// 2. 키 존재 여부 검사
if (array_key_exists('name', $user)) { /* ... */ }

// 3. 변환 (array_map) & 필터링 (array_filter)
$numbers = [1, 2, 3, 4, 5, 6];
$evens = array_filter($numbers, fn($n) => $n % 2 === 0); // [2, 4, 6]
$squares = array_map(fn($n) => $n * 2, $numbers);        // [2, 4, 6, 8, 10, 12]

// 4. 컬럼 추출 (array_column: DB 결과셋 가공에 탁월)
$users = [
    ['id' => 1, 'name' => 'Alice'],
    ['id' => 2, 'name' => 'Bob']
];
$names = array_column($users, 'name', 'id'); // [1 => 'Alice', 2 => 'Bob']
```

## 5. 문자열 & 유틸리티 함수 (Strings: PHP 8+)
```php
<?php
$str = "Hello, Lucky World!";

// [1] 현대적 문자열 탐색 함수 (PHP 8.0+)
str_contains($str, "Lucky");       // true (포함 여부)
str_starts_with($str, "Hello");    // true (접두사 검사)
str_ends_with($str, "World!");     // true (접미사 검사)

// [2] 분할 및 결합 (explode / implode)
$tags = "php,laravel,backend";
$tagArray = explode(',', $tags);   // ['php', 'laravel', 'backend']
$tagString = implode(' | ', $tagArray); // "php | laravel | backend"

// [3] 공백 제거 & 대소문자 & 포맷팅
$clean = trim("  hello  \n");       // "hello"
$upper = strtoupper("lucky");       // "LUCKY"
$padded = sprintf("ID: %04d", 5);   // "ID: 0005"
$length = mb_strlen("한글", "UTF-8"); // 2 (멀티바이트 문자열 길이)
```

## 6. 객체 지향 프로그래밍 (OOP: Classes, Interfaces, Traits)
```php
<?php
interface Identifiable {
    public function getId(): int;
}

abstract class BaseEntity implements Identifiable {
    public function __construct(protected int $id) {}
    public function getId(): int { return $this->id; }
}

// 재사용 가능한 코드 조각 (Trait)
trait Timestampable {
    public \DateTimeImmutable $createdAt;
    public function initTimestamp(): void {
        $this->createdAt = new \DateTimeImmutable();
    }
}

class Product extends BaseEntity {
    use Timestampable; // 트레이트 사용

    public function __construct(
        int $id,
        public string $title,
        public int $price
    ) {
        parent::__construct($id);
        $this->initTimestamp();
    }
}
```

## 7. 데이터베이스 연동 (PDO & Prepared Statements)
```php
<?php
// [1] PDO 연결 생성 (MySQL / MariaDB)
$dsn = "mysql:host=127.0.0.1;dbname=app_db;charset=utf8mb4";
$options = [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,        // 에러 발생 시 예외 던짐
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,     // 연관 배열로 조회
    PDO::ATTR_EMULATE_PREPARES => false,                // 네이티브 프리페어드 스테이트먼트 강제
];

$pdo = new PDO($dsn, "db_user", "db_pass", $options);

// [2] 안전한 쿼리 조회 (SQL Injection 완벽 차단)
$stmt = $pdo->prepare("SELECT id, name, email FROM users WHERE role = :role AND is_active = :active");
$stmt->execute([
    ':role' => 'ADMIN',
    ':active' => 1
]);
$admins = $stmt->fetchAll(); // 전체 행 반환

// [3] 데이터 삽입 & 트랜잭션
try {
    $pdo->beginTransaction();

    $insert = $pdo->prepare("INSERT INTO users (name, email) VALUES (?, ?)");
    $insert->execute(["Lucky", "lucky@test.com"]);
    $newId = $pdo->lastInsertId();

    $pdo->commit();
} catch (Exception $e) {
    $pdo->rollBack();
    error_log("DB 트랜잭션 실패: " . $e->getMessage());
}
```

## 8. 웹 요청 & 슈퍼글로벌 (Superglobals: GET, POST, FILES)
```php
<?php
// [1] GET / POST 파라미터 안전한 수신
$keyword = filter_input(INPUT_GET, 'keyword', FILTER_DEFAULT);
$page = filter_input(INPUT_GET, 'page', FILTER_VALIDATE_INT) ?: 1;

// [2] 세션(Session) & 쿠키(Cookie)
session_start();
$_SESSION['user_id'] = 100; // 세션 데이터 저장
$currentUserId = $_SESSION['user_id'] ?? null;

// 보안 쿠키 설정 (HttpOnly, Secure, SameSite)
setcookie('theme', 'dark', [
    'expires' => time() + 86400 * 30,
    'path' => '/',
    'secure' => true,      // HTTPS에서만 전송
    'httponly' => true,    // 자바스크립트 접근 차단 (XSS 방어)
    'samesite' => 'Lax'
]);

// [3] 안전한 파일 업로드 검증 ($_FILES)
if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['avatar'])) {
    $file = $_FILES['avatar'];
    if ($file['error'] === UPLOAD_ERR_OK) {
        $allowedTypes = ['image/jpeg', 'image/png'];
        $finfo = finfo_open(FILEINFO_MIME_TYPE);
        $mime = finfo_file($finfo, $file['tmp_name']);

        if (in_array($mime, $allowedTypes, true)) {
            $dest = 'uploads/' . bin2hex(random_bytes(16)) . '.jpg';
            move_uploaded_file($file['tmp_name'], $dest);
        }
    }
}
```

## 9. JSON API 응답 처리 (JSON & HTTP Headers)
```php
<?php
// REST API 표준 JSON 응답 생성
header('Content-Type: application/json; charset=utf-8');

$requestBody = file_get_contents('php://input'); // 원시 JSON 바디 수신
$payload = json_decode($requestBody, true, 512, JSON_THROW_ON_ERROR);

$response = [
    'success' => true,
    'data' => [
        'id' => 1,
        'message' => '처리가 완료되었습니다.'
    ],
    'timestamp' => time()
];

http_response_code(200); // HTTP 200 OK
echo json_encode($response, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
exit;
```

## 10. 예외 처리 & 에러 핸들링 (Exception Handling)
```php
<?php
class UserNotFoundException extends Exception {}

function findUser(int $id): array {
    if ($id <= 0) {
        throw new InvalidArgumentException("ID는 양수여야 합니다.");
    }
    // 사용자 없을 시
    throw new UserNotFoundException("사용자를 찾을 수 없습니다: {$id}");
}

try {
    $user = findUser(-1);
} catch (InvalidArgumentException $e) {
    echo "잘못된 인자: " . $e->getMessage();
} catch (UserNotFoundException $e) {
    echo "사용자 없음: " . $e->getMessage();
} catch (Throwable $e) { // 모든 에러 및 예외의 최상위 인터페이스
    echo "예기치 못한 치명적 오류: " . $e->getMessage();
} finally {
    // 리소스 정리
}
```

## 11. 패키지 관리 & 오토로딩 (Composer & PSR-4)
```bash
# 📦 Composer 핵심 명령어
composer init                  # 대화형으로 composer.json 생성
composer require guzzlehttp/guzzle # 외부 패키지 설치
composer require --dev phpunit/phpunit # 개발 전용 패키지 설치
composer install               # composer.lock 기준으로 일괄 설치
composer update                # 패키지 최신 버전 갱신
composer dump-autoload -o      # 오토로더 클래스맵 최적화 (프로덕션 배포 필수)
```
```json
// composer.json - PSR-4 오토로딩 설정
{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}
```
```php
<?php
// index.php - 진입점에서 단 1줄로 모든 클래스 자동 로딩
require_once __DIR__ . '/vendor/autoload.php';

use App\Services\OrderService;
$orderService = new OrderService();
```

## 12. 실무 보안 & php.ini 성능 최적화 (Security & OPcache)
```php
<?php
// [1] XSS 방어: 출력 시 반드시 이스케이프 처리
echo htmlspecialchars($userInput, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');

// [2] 비밀번호 안전한 암호화 (Bcrypt / Argon2)
$hash = password_hash("mysecretpass", PASSWORD_DEFAULT);
// 비밀번호 일치 검증
if (password_verify("mysecretpass", $hash)) {
    // 인증 성공
}
```
```ini
; [3] php.ini 프로덕션 필수 권장 설정
display_errors = Off              ; 브라우저에 에러 상세 노출 차단 (보안)
log_errors = On                   ; 에러는 파일로 안전하게 기록
error_log = /var/log/php_errors.log
expose_php = Off                  ; HTTP 응답 헤더에서 PHP 버전 숨김
upload_max_filesize = 20M
post_max_size = 25M

; [4] OPcache 활성화 (PHP 바이트코드 캐시로 성능 3배 이상 향상)
opcache.enable = 1
opcache.memory_consumption = 128
opcache.interned_strings_buffer = 8
opcache.max_accelerated_files = 10000
opcache.validate_timestamps = 0   ; 프로덕션: 파일 변경 감지 비활성화로 디스크 I/O 제거
```
💬
PHP 치트시트

의견 및 질문

댓글 수정

댓글 삭제
