PHP Kurulumu: Windows, Mac ve Linux (php -v Kontrolü)

PHP'yi kurmak için sisteminize uygun tek bir komut çalıştırın: Windows'ta winget install PHP.PHP.8.3, macOS'ta brew install php, Ubuntu ve Debian'da sudo apt install php-cli. Ardından yeni bir terminal açıp php -v çalıştırın. Bir sürüm numarası yazdırıyorsa PHP kurulmuştur.

php -v

PHP 8.3.19 (cli) (built: Mar 27 2025 11:08:15) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.3.19, Copyright (c) Zend Technologies
    with Zend OPcache v8.3.19, Copyright (c), by Zend Technologies

Sizin sürümünüz ve derleme tarihiniz farklı olacaktır. Bir betiğin içinde aynı bilgi PHP_VERSION ve phpversion() ile alınır. Bu sayfadaki PHP'nin ne bildirdiğini görmek için Run'a basın:

<?php
echo "PHP version: " . phpversion() . "\n";
echo "Version as a number: " . PHP_VERSION_ID . "\n";
echo "Operating system family: " . PHP_OS_FAMILY . "\n";
echo "Integer size: " . PHP_INT_SIZE * 8 . " bit\n";

Windows'ta PHP kurulumu

En hızlı yol, Windows 10 ve 11 ile birlikte gelen winget'tir. PowerShell'i veya Windows Terminal'i açın:

winget install PHP.PHP.8.3

Terminali kapatın, yenisini açın ve php -v çalıştırın. Yeni pencere gerekir, çünkü terminaller başladıkları andaki PATH'i kullanır.

Elle kurmak isterseniz:

1. windows.php.net/download adresinden "VS16 x64 Non Thread Safe" zip dosyasını indirin.
2. C:\php gibi kısa bir yola çıkarın.
3. Aynı klasörde php.ini-development dosyasını php.ini olarak kopyalayın.
4. C:\php yolunu Path değişkenine ekleyin (Başlat menüsü, "Sistem ortam değişkenlerini düzenleyin", Ortam Değişkenleri).
5. Yeni bir terminal açın ve php -v çalıştırın.

Apache ve MySQL'i de tek bir kurulum dosyasında istiyorsanız XAMPP ve Laragon bunları PHP ile birlikte paketler.

macOS'ta PHP kurulumu

macOS artık PHP içermiyor. Homebrew ile kurun:

brew install php
php -v

brew install php size en son sürümü verir. Bir sürümü sabitlemek için onu adıyla kurun, örneğin brew install php@8.3. Sürümlü formüller varsayılan olarak bağlanmaz; bu yüzden Homebrew'un kurulumun sonunda yazdırdığı komutla onu PATH değişkeninize ekleyin. Daha sonra brew upgrade php ile güncellersiniz.

Linux'ta PHP kurulumu

Ubuntu 24.04 ve Debian 13 kendi depolarında PHP 8.3 veya daha yenisini sunar:

sudo apt update
sudo apt install php-cli php-mbstring php-xml php-curl
php -v

Fedora, RHEL ve benzeri sistemlerde:

sudo dnf install php-cli php-mbstring php-xml
php -v

Eklentiler php-<name> adlı ayrı paketlerdir: Debian ve Ubuntu'da php-mysql MySQL sürücülerini (Fedora'da php-mysqlnd), php-intl ise intl eklentisini ekler. Ubuntu'da dağıtımınızın sunduğundan daha yeni bir PHP için yaygın olarak kullanılan ppa:ondrej/php deposu desteklenen her sürümü içerir:

sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.3-cli

Kodda PHP sürümünü kontrol etmek

Kütüphaneler çoğu zaman minimum bir sürüm ister. version_compare sürüm stringlerini PHP'nin yaptığı gibi karşılaştırır, PHP_VERSION_ID ise karşılaştırması kolay düz bir tam sayı verir (80300, 8.3.0 demektir):

<?php
$required = '8.1.0';

if (version_compare(PHP_VERSION, $required, '>=')) {
    echo "PHP " . PHP_VERSION . " is new enough (need $required)\n";
} else {
    echo "Please upgrade: this code needs PHP $required\n";
}

echo PHP_VERSION_ID >= 80300 ? "8.3 features are available\n" : "Older than 8.3\n";
echo "Major: " . PHP_MAJOR_VERSION . ", minor: " . PHP_MINOR_VERSION . "\n";

Hangi eklentilerin kurulu olduğunu kontrol etmek

Yeni bir kurulumdan sonraki hataların çoğu eksik bir eklentidir. Terminalde php -m yüklü her eklentiyi listeler. Kodda extension_loaded bir eklentiyi adıyla kontrol eder:

<?php
$needed = ['mbstring', 'json', 'ctype', 'dom'];

foreach ($needed as $ext) {
    $status = extension_loaded($ext) ? 'loaded' : 'MISSING';
    printf("%-10s %s\n", $ext, $status);
}

echo "\nTotal extensions loaded: " . count(get_loaded_extensions()) . "\n";

Projenizin ihtiyaç duyduğu adları ekleyin (örneğin pdo_mysql, intl, gd) ve neyi kurmanız gerektiğini görmek için kendi bilgisayarınızda çalıştırın.

php.ini dosyasını bulmak

display_errors, memory_limit ve upload_max_filesize gibi ayarlar php.ini içinde bulunur. Terminal komutu php --ini hangi dosyanın yüklendiğini yazdırır. Koddan:

<?php
$ini = php_ini_loaded_file();
echo $ini === false ? "No php.ini loaded, PHP uses its defaults\n" : "Loaded: $ini\n";

echo "memory_limit = " . ini_get('memory_limit') . "\n";
echo "max_execution_time = " . ini_get('max_execution_time') . "\n";

CLI ve web sunucusu farklı php.ini dosyaları kullanabilir; bu yüzden birinde değiştirilen bir ayar her zaman diğerine uygulanmaz. Hata raporlama sayfası geliştirme bilgisayarında önce değiştirilmeye değer ayarları gösterir.

Sık karşılaşılan sorun: terminal hâlâ eski sürümü çalıştırıyor

Güncellemeden sonra php -v bazen önceki sürümü bildirir. Terminalin önce hangi dosyayı bulduğunu görmek için which php (macOS, Linux) veya where php (Windows) çalıştırın. macOS'ta bu çoğu zaman kurulu ama bağlanmamış bir Homebrew sürümüdür; Windows'ta genellikle Path içinde daha önce gelen eski bir klasördür, örneğin XAMPP'nin içindeki. Sırayı düzeltin, yeni bir terminal açın ve tekrar kontrol edin. Ardından PHP dosyalarını çalıştırma sayfasıyla devam edin.