PHP 기초 입문 튜토리얼

PHP란 무엇이고 어디에 쓰이는가

PHP는 1994년 라스무스 러도프(Rasmus Lerdorf)가 만들었으며, 지금 이름은 "PHP: Hypertext Preprocessor"의 약자입니다. 거의 모든 웹 호스팅에서 실행되며 WordPress, Drupal, Wikipedia의 MediaWiki를 비롯해 많은 웹사이트를 움직입니다. 콘텐츠 사이트, 온라인 쇼핑몰, REST API, 그리고 Laravel이나 Symfony 같은 프레임워크를 이용한 본격적인 웹 애플리케이션에 쓰입니다. 최신 PHP 8에는 타입 시스템, JIT 컴파일러, 열거형, 어트리뷰트가 있고 예전 버전보다 성능이 훨씬 좋아졌습니다.

PHP 설치와 Hello, world 실행

php.net이나 패키지 관리자(brew install php, sudo apt install php-cli, Windows의 XAMPP 같은 번들)로 PHP를 설치하세요. php -v로 확인합니다. PHP 코드는 <?php와 선택적인 닫는 ?> 태그 사이에 씁니다.

<?php
echo "Hello, world\n";

php hello.php
# Hello, world
php -S localhost:8000    # serve the current folder at http://localhost:8000

PHP 코드만 들어 있는 파일에서는 닫는 ?> 태그를 생략하세요. 그러면 실수로 공백이 브라우저에 전송되는 일이 없습니다.

변수와 기본 자료형

변수 이름은 $로 시작합니다. 타입은 동적이지만 매개변수와 반환 타입을 선언할 수 있고, 파일 맨 위의 declare(strict_types=1);은 함수 호출에서 자동 형 변환을 막습니다.

<?php
$name = "Ada";
$count = 7;
echo "$name has $count items\n";        // Ada has 7 items
echo 'No $interpolation here' . "\n";   // No $interpolation here
echo intdiv($count, 2), " ", $count / 2, "\n";  // 3 3.5
var_dump((int) "12" + 1);                // int(13)

. 연산자는 문자열을 이어 붙이고, +는 숫자에만 사용합니다.

제어 흐름

<?php
$score = 72;
if ($score >= 90) {
    echo "A\n";
} elseif ($score >= 70) {
    echo "B\n";                   // B
} else {
    echo "C\n";
}

for ($i = 0; $i < 3; $i++) {
    echo $i, " ";                 // 0 1 2
}
echo "\n";

foreach (["apple", "pear"] as $fruit) {
    echo $fruit, "\n";
}

$kind = match ($day = "SAT") {   // match is strict and returns a value
    "SAT", "SUN" => "weekend",
    default => "weekday",
};
echo $kind, "\n";                 // weekend

match(PHP 8.0 이상)는 ===로 비교하고 일치하는 분기가 없으면 오류를 던집니다. 느슨하게 비교하고 break가 없으면 다음 case로 넘어가는 예전 switch와 다릅니다.

함수

<?php
declare(strict_types=1);

function greet(string $name, string $greeting = "Hello"): string
{
    return "$greeting, $name!";
}

echo greet("Lin"), "\n";                    // Hello, Lin!
echo greet(greeting: "Hi", name: "Lin"), "\n"; // Hi, Lin!  (named arguments)

$square = fn(int $x): int => $x * $x;       // arrow function
echo $square(5), "\n";                      // 25

function total(int ...$nums): int           // variadic
{
    return array_sum($nums);
}
echo total(1, 2, 3), "\n";                  // 6

대표 기능: 배열

PHP 배열은 리스트, 딕셔너리, 스택, 큐로 모두 쓸 수 있는 하나의 유연한 타입입니다. 키는 정수 또는 문자열이며 삽입 순서가 유지됩니다. 배열을 다루는 내장 함수가 많이 준비되어 있습니다.

<?php
$nums = [3, 1, 2];
$nums[] = 5;                       // append
sort($nums);
echo implode(", ", $nums), "\n";   // 1, 2, 3, 5

$ages = ["ann" => 31, "bob" => 25];
$ages["cy"] = 40;
foreach ($ages as $person => $age) {
    echo "$person is $age\n";
}
echo $ages["zed"] ?? 0, "\n";      // 0  (null coalescing)

$evens = array_filter($nums, fn($n) => $n % 2 === 0);
$squares = array_map(fn($n) => $n * $n, $nums);
echo json_encode(array_values($evens)), " ", json_encode($squares), "\n";  // [2] [1,4,9,25]
echo count($ages), " ", array_key_exists("bob", $ages) ? "yes" : "no", "\n"; // 3 yes

배열은 대입할 때 복사됩니다(copy-on-write). 핸들로 전달되는 객체와 다릅니다.

클래스, 생성자 프로모션, 열거형

<?php
declare(strict_types=1);

enum Role: string
{
    case Admin = "admin";
    case Viewer = "viewer";
}

final class User
{
    public function __construct(
        public readonly string $name,
        public readonly Role $role = Role::Viewer,
    ) {}

    public function label(): string
    {
        return "{$this->name} ({$this->role->value})";
    }
}

$u = new User("Ann", Role::Admin);
echo $u->label(), "\n";               // Ann (admin)
echo Role::from("viewer")->name, "\n"; // Viewer

생성자 프로모션(PHP 8.0)은 생성자 시그니처에서 속성을 선언하고 대입까지 합니다. readonly 속성(8.1)은 한 번만 설정할 수 있고, 값을 가진 열거형(8.1)은 case를 문자열이나 정수에 대응시킵니다. 인터페이스, 추상 클래스, 트레이트도 사용할 수 있습니다.

오류 처리

최신 PHP는 대부분의 오류에서 예외를 던집니다. 예상되는 실패에는 Exception 하위 클래스를 잡고, Throwable은 TypeError 같은 엔진 오류까지 포함합니다.

<?php
function parseAge(string $text): int
{
    if (!ctype_digit($text)) {
        throw new InvalidArgumentException("invalid age: $text");
    }
    return (int) $text;
}

try {
    echo parseAge("41"), "\n";   // 41
    echo parseAge("abc"), "\n";
} catch (InvalidArgumentException $e) {
    echo $e->getMessage(), "\n"; // invalid age: abc
} finally {
    echo "done\n";
}

작은 완성 프로그램: JSON API 엔드포인트

이 코드를 api.php로 저장하고 php -S localhost:8000을 실행한 뒤 http://localhost:8000/api.php?name=Ann을 여세요. 쿼리 매개변수를 읽어 검증하고 JSON을 반환합니다.

<?php
declare(strict_types=1);

header("Content-Type: application/json; charset=utf-8");

$name = trim($_GET["name"] ?? "");
if ($name === "" || mb_strlen($name) > 50) {
    http_response_code(400);
    echo json_encode(["error" => "name must be 1 to 50 characters"]);
    exit;
}

$response = [
    "message" => "Hello, $name!",
    "length" => mb_strlen($name),
    "time" => date(DATE_ATOM),
];
echo json_encode($response, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);

$_GET, $_POST, $_COOKIE에는 요청 데이터가 들어 있습니다. 그 안의 모든 값은 신뢰할 수 없는 값으로 취급하세요.

초보자가 자주 하는 실수

• 타입을 변환하는 ==로 비교하는 경우. ===와 !==를 사용하세요.
• 변수 이름의 $나 문장 끝의 세미콜론을 빠뜨리는 경우.
• md5나 sha1로 비밀번호를 저장하는 경우. password_hash와 password_verify를 사용하세요.
• UTF-8 텍스트에 strlen을 쓰는 경우. 이 함수는 바이트를 셉니다. 문자 수는 mb_strlen을 사용하세요.
• 오래된 PHP 버전을 쓰는 경우. 보안 패치와 최신 기능을 위해 지원되는 PHP 8 릴리스를 사용하세요.

다음 학습 단계

php.net의 공식 PHP Manual에는 모든 함수와 언어 레퍼런스, 사용자 노트가 있습니다. 패키지 관리자 Composer와 PSR 코딩 표준을 익힌 뒤 애플리케이션용 Laravel이나 Symfony, 작은 API용 Slim 같은 프레임워크를 써 보세요. PHPUnit은 표준 테스트 도구입니다.