Jak uruchomić plik PHP: wiersz poleceń i serwer php -S

Aby uruchomić plik PHP, otwórz terminal w jego folderze i wpisz php index.php. PHP wykona plik i wypisze wynik w terminalu. Aby zobaczyć stronę PHP w przeglądarce, uruchom wbudowany serwer poleceniem php -S localhost:8000 i otwórz http://localhost:8000.

php index.php

Pierwszy index.php może mieć jedną linię. Kliknij Run: dokładnie to wypisuje php index.php.

<?php
echo "Hello from PHP " . PHP_VERSION . "\n";
echo "2 + 3 = " . (2 + 3) . "\n";

Kod PHP zaczyna się po znaczniku <?php. Wszystko przed tym znacznikiem jest wypisywane jako zwykły tekst i właśnie tak PHP łączy kod z HTML.

Uruchamianie pliku PHP z wiersza poleceń

PHP CLI (interfejs wiersza poleceń) wykonuje skrypt raz i kończy działanie. Potrzebujesz zainstalowanego PHP; jeśli php -v zwraca błąd, zajrzyj najpierw do instalacji PHP.

cd ~/projects/hello
php index.php          # run the file
php -l index.php       # only check the syntax ("lint")
php index.php > out.txt   # save the output to a file

php -l przydaje się przed wysłaniem pliku na serwer: zgłasza błąd parsowania z numerem linii albo wypisuje No syntax errors detected in index.php.

Przekazywanie argumentów przez $argv

Słowa po nazwie pliku trafiają do $argv. $argv[0] to zawsze nazwa samego skryptu, a $argc to liczba elementów razem z tą nazwą. Tutaj blok działa bez dodatkowych argumentów, więc jest tylko nazwa:

<?php
echo "Script: " . $argv[0] . "\n";
echo "Argument count: " . $argc . "\n";

// Run as: php index.php Ada 3
$name  = $argv[1] ?? 'world';
$times = (int) ($argv[2] ?? 1);

for ($i = 0; $i < $times; $i++) {
    echo "Hello, $name\n";
}

Na własnym komputerze php index.php Ada 3 wypisze powitanie trzy razy. Wartości zastępcze po ?? sprawiają, że skrypt działa, gdy brakuje argumentu. Dla nazwanych opcji, takich jak --name=Ada, użyj getopt:

<?php
// php index.php --name=Ada --verbose
$opts = getopt('', ['name:', 'verbose']);
echo "Hello, " . ($opts['name'] ?? 'world') . "\n";
if (isset($opts['verbose'])) {
    echo "Verbose mode\n";
}

Uruchamianie PHP w przeglądarce przez php -S

PHP ma wbudowany serwer WWW do celów deweloperskich. Uruchom go w folderze ze swoimi plikami:

php -S localhost:8000

[Sat Oct  3 07:21:34 2026] PHP 8.3.19 Development Server (http://localhost:8000) started

Teraz http://localhost:8000/ uruchamia index.php, a http://localhost:8000/about.php uruchamia about.php. Każde wczytanie strony wykonuje plik od nowa, z query stringiem w $_GET. Poniższy blok działa tak samo: uruchom go, kliknij link, a skrypt wykona się ponownie z ustawionym $_GET['page'].

<?php
$pages = [
    'home'    => 'Welcome to the bakery.',
    'menu'    => 'Bread, pastries and coffee.',
    'contact' => 'Call us at 555 0100.',
];
$page = $_GET['page'] ?? 'home';
$text = $pages[$page] ?? 'Page not found.';
?>
<nav>
    <a href="?page=home">Home</a> |
    <a href="?page=menu">Menu</a> |
    <a href="?page=contact">Contact</a>
</nav>
<h1><?= htmlspecialchars(ucfirst($page)) ?></h1>
<p><?= htmlspecialchars($text) ?></p>

Przydatne opcje:

php -S localhost:8000 -t public        # serve the public/ folder as the web root
php -S 0.0.0.0:8000                    # reachable from other devices on your network
php -S localhost:8000 router.php       # send every request through router.php

Wbudowany serwer obsługuje jedno żądanie naraz i jest przeznaczony wyłącznie do developmentu. Na produkcji PHP działa za Nginx albo Apache, zwykle przez PHP-FPM.

Sprawdzanie, jak skrypt został uruchomiony

PHP_SAPI mówi, które „server API” wykonuje skrypt: cli w terminalu, cli-server pod php -S, a fpm-fcgi lub apache2handler za prawdziwym serwerem WWW. Skrypty, które mają działać tylko z terminala, sprawdzają to na początku:

<?php
echo "Running under: " . PHP_SAPI . "\n";
echo "Script name: " . basename(__FILE__) . "\n";

if (PHP_SAPI === 'cli') {
    echo "Command line: plain text output, no HTML needed\n";
} else {
    echo "<p>Web request: send HTML</p>\n";
}

Jedna linia przez php -r

Do szybkiego testu nie potrzebujesz pliku. php -r wykonuje przekazany kod, bez znacznika <?php:

php -r 'echo date("Y-m-d"), PHP_EOL;'
php -r 'var_dump(0.1 + 0.2 == 0.3);'

W cmd na Windowsie umieść kod w podwójnych cudzysłowach, a w środku używaj pojedynczych. Dla kilku linii php -a otwiera powłokę interaktywną, w której każda instrukcja wykonuje się po naciśnięciu Enter.

Skrypt wykonywalny na macOS i Linuksie

Dodaj linię shebang przed <?php i oznacz plik jako wykonywalny. Linia shebang nie jest wypisywana:

#!/usr/bin/env php
<?php
echo "Backup started\n";

chmod +x backup.php
./backup.php

Tak uruchamia się skrypty PHP z crona: 0 3 * * * /usr/bin/php /home/me/backup.php.

Kody wyjścia skryptów

Skrypt wiersza poleceń zgłasza sukces lub porażkę przez kod wyjścia, który mogą sprawdzić skrypty powłoki i cron. exit(0) oznacza sukces, każda inna liczba oznacza błąd:

<?php
$file = $argv[1] ?? '';
if (!is_file($file)) {
    fwrite(STDERR, "File not found: $file\n");
    exit(1);
}
echo "Processing $file\n";
exit(0);

Częsty błąd: zły plik lub zły folder

Could not open input file: index.php oznacza, że PHP nie widzi pliku z miejsca, w którym jest terminal. Sprawdź bieżący folder przez pwd (albo cd na Windowsie) i albo przejdź przez cd do projektu, albo podaj pełną ścieżkę: php ~/projects/hello/index.php. Przy php -S błąd 404 dla strony, która na pewno istnieje, zwykle oznacza, że serwer uruchomiono w innym folderze; zatrzymaj go przez Ctrl+C i uruchom ponownie we właściwym miejscu albo wskaż folder przez -t. Gdy plik się wykonuje, ale pokazuje pustą stronę, włącz raportowanie błędów, aby zobaczyć, co poszło nie tak.