Lighttpd'ye PHP süreçlerini çatallattırmak

Lighttpd'nin PHP'ye bağlanmasını ve fastcgi süreçlerini çatallamasını sağlamak üzere yapılandırmak için lighttpd.conf dosyasını düzenlemeniz gerekir. FastCGI süreçlerine yerel sistemden bağlanmak için soketler tercih edilir.

server.modules += ( "mod_fastcgi" )

fastcgi.server = ( ".php" =>
  ((
    "socket" => "/tmp/php.socket",
    "bin-path" => "/usr/local/bin/php-cgi",
    "bin-environment" => (
      "PHP_FCGI_CHILDREN" => "16",
      "PHP_FCGI_MAX_REQUESTS" => "10000"
    ),
    "min-procs" => 1,
    "max-procs" => 1,
    "idle-timeout" => 20
  ))
)

bin-path yönergesi lighttpd'nin fastcgi süreçlerini dinamik olarak çatallamasına izin verir. PHP kendi çocuklarını PHP_FCGI_CHILDREN ortam değişkenine göre çatallayacaktır. Çatallanan sürecin ortamını bin-environment yönergesi tanımlar. PHP, PHP_FCGI_MAX_REQUESTS değerinin aşılmasına sebep olan çocuk süreci öldürür. PHP'de min-procs ve max-procs yönergelerinden genel olarak kaçınılması gerekir. PHP kendi çocuklarını yönetir ve makine kodu önbelleklerini APC gibi çocukları arasında paylaştırır. min-procs yönergesine 1'den büyük bir değer atanmışsa PHP yanıtçılarının sayısı PHP_FCGI_CHILDREN değerinin katları olacaktır (2 min-procs * 16 çocuk eşittir 32 yanıtçı).

Spawn-fcgi ile çatallama

Lighttpd, FastCGI süreçlerinin çatallanmasını kolaylaştırmak için spawn-fcgi adında bir uygulamayla gelir.

php-cgi'nin çatallanması

Süreçleri spawn-fcgi kullanmaksızın çatallamak mümkünse de, biraz ağır kaldırma çalışmak gerekir. Gelen istekleri karşılamak için PHP'nin kaç çocuk çatallayacağı PHP_FCGI_CHILDREN ortam değişkeni ile belirlenir. PHP'nin her çocuğunun kaç isteklik yaşayacağını ise PHP_FCGI_MAX_REQUESTS belirler. Aşağıda, PHP yanıtçılarının çatallanmasına yardımcı olan basit bir bash betiği verilmiştir.

#!/bin/sh

# php-cgi çalıştırılabilirinin yeri
PHP=/usr/local/bin/php-cgi

# PID dosyasının yeri
PHP_PID=/tmp/php.pid

# Dinlenecek adres
#FCGI_BIND_ADDRESS=10.0.1.1:10000
# Dinlenecek soket
FCGI_BIND_ADDRESS=/tmp/php.sock

PHP_FCGI_CHILDREN=16
PHP_FCGI_MAX_REQUESTS=10000

env -i PHP_FCGI_CHILDREN=$PHP_FCGI_CHILDREN \
       PHP_FCGI_MAX_REQUESTS=$PHP_FCGI_MAX_REQUESTS \
       $PHP -b $FCGI_BIND_ADDRESS &

echo $! > "$PHP_PID"

Uzak FCGI (nesnel) örneklerine bağlanmak

Uygulamaları dengelemek için FastCGI örnekleri çok sayıda uzak makineye çatallanabilir.

fastcgi.server = ( ".php" =>
   (( "host" => "10.0.0.2", "port" => 1030 ),
    ( "host" => "10.0.0.3", "port" => 1030 ))
)

Sınama

PHP'yi bir CGI programı olarak derlediyseniz, derlemenizi make test komutunu vererek sınayabilirsiniz. Derlemenizi sınamak daima iyidir. Bu yolla sonradan karşılaşabileceğiniz sorunları daha ortaya çıkmadan yakalama şansınız olur.

Değişkenlerin kullanımı

Bazı sunucu kaynaklı ortam değişkenleri geçerli » CGI/1.1 belirtiminde tanımlanmamıştır; sadece şu değişkenler tanımlıdır: AUTH_TYPE, CONTENT_LENGTH, CONTENT_TYPE, GATEWAY_INTERFACE, PATH_INFO, PATH_TRANSLATED, QUERY_STRING, REMOTE_ADDR, REMOTE_HOST, REMOTE_IDENT, REMOTE_USER, REQUEST_METHOD, SCRIPT_NAME, SERVER_NAME, SERVER_PORT, SERVER_PROTOCOL ve SERVER_SOFTWARE. Bunların dışında kalan herşey 'üretici eklentileri' olarak ele alınmalıdır.

İkil Paketlerin Kullanımı

PHP'yi OpenBSD üzerine kurmak için ikil paketlerin kullanımı en basit ve önerilen bir yoldur. Temel paket, modül paketlerinden ayrıdır ve her modül paketi diğerlerinden bağımsız olarak kurulup kaldırılabilir. İhtiyaç duyacağınız dosyaları OpenBSD CD'nizde veya FTP sitesinde bulabilirsiniz.

İhtiyacınız olan ana paket php olup, temel motoru (artı fpm, gettext ve iconv) içerir ve aralarından seçim yapabileceğiniz çeşitli sürümler de mevcut olabilir. Modül paketleri ise php-mysql veya php-imap gibi isimler alırlar. Bu modülleri php.ini dosyanızda etkin ve etkisiz kılmak için phpxs komutuna ihtiyacınız olacak.

# pkg_add php
# pkg_add php-apache
# pkg_add php-mysqli
  (PEAR kütüphanesini kur)
# pkg_add pear

Paketlerle ilgili talimatları izle
  (paketleri kaldırmak için)
# pkg_delete php
# pkg_delete php-apache
# pkg_delete php-mysqli
# pkg_delete pear

OpenBSD'deki ikil paketler hakkında ayrıntılı bilgi edinmek için » packages(7) kılavuz sayfasını okuyunuz.

Portların Kullanımı

Ayrıca, PHP'yi kaynak paketinden » port ağacını kullanarak da derleyebilirsiniz. Ancak, bu sadece OpenBSD üzerinde tecrübeli kullanıcılar için önerilebilecek bir yoldur. PHP portu iki alt dizine ayrılır: çekirdek ve eklentiler. Eklentilerin bulunduğu dizin desteklenen tüm PHP modülleri için alt paketler üretir. Bu modüllerden üretilmesini istemedikleriniz için no_* FLAVOR'unu kullanınız. Örneğin imap modülünün derlenmeden geçilmesi için FLAVOR'a no_imap atayınız.

Bilinen Sorunlar

• Apache ve Nginx artık OpenBSD'nin öntanımlı sunucusu olmamakla beraber her ikiksi de portlarda ve paketlerde kolayca bulunabilir. Yeni öntanımlı sunucu 'httpd'dir.
• httpd'nin öntanımlı kurulumu bir » chroot(2) hücresinde çalışır, böylece PHP betiklerinin /var/www altındaki dosyalara erişmesi engellenir. Bu bakımdan PHP oturum dosyalarının saklanması için ya /var/www/tmp diye bir dizine ya da başka bir oturum arayüzü kullanmaya ihtiyacınız olacaktır. Buna ek olarak, veritabanı soketlerinin de hücre içine yerleştirilmesi veya localhost arayüzünü dinlemesi gerekir. Ağ işlevleri kullanıyorsanız, /etc dizinindeki /etc/resolv.conf ve /etc/services gibi dosyaların /var/www/etc dizinine taşınması gerekecektir. OpenBSD PEAR paketi otomatik olarak doğru chroot dizinlerine kurulur.
• » gd eklentisi için, OpenBSD paketi Xorg'un kurulu olmasını gerektirir. xbase.tgz dosya kümesi eklenerek temel kurulumda zaten kurulmadıysa, kurulum sonrasında eklenebilir (Bkz: » OpenBSD FAQ#4).

Gerekli Yazılımlar

Solaris kurulumlarında sıklıkla C derleyicilerin ve bunlarla ilgili araçların yokluğu sözkonusu olur. Bu araçların GNU sürümlerinin gerekliliği hakkında bilgi edinmek için lütfen SSS'nin bu bölümünü okuyunuz.

PHP paketini açmak için gerekenler:

• tar
• gzip veya
• bzip2

PHP'yi derlemek için gerekenler:

• gcc (önerilir, fakat başka C derleyiciler de iş görür)
• make
• GNU sed

PHP koduyla oynamak veya eklentileri derlemek için ayrıca gerekenler:

• re2c
• bison
• m4
• autoconf
• automake

Paketlerin kullanımı

Kurulması gereken bileşinlerin çoğunu kurmak için pkgadd kullanarak Solaris kurulum işlemlerini kolaylaştırabilirsiniz. Solaris 11 Express için Image Packaging System (IPS) de pkg komutunu kullanarak kurulum için gereken bileşenlerin çoğunu içermektedir.

APT kullanımı

Öncelikle dikkat edeceğiniz şey, Apache2 ile tümleştirmek için libapache-mod-php ve PEAR ile tümleştirmek için php-pear gibi PHP ile ilgili diğer paketlerinde gerekli olabileceğidir.

İkinci olarak, bir paketi kurmadan önce paket listesini güncellemeniz yerinde bir hareket olacaktır. Bu işlem genellikle apt update komutu çalıştırılarık yapılır.

# apt install php5-common libapache2-mod-php5 php5-cli

APT, Apache2 için hazırlanmış PHP modülünü ve bu modülü etkinleştirmek için bağımlı olduğu diğer paketleri otomatik olarak kuracaktır. Yapılan değişikliğin geçerli olması için Apache2 yeniden başlatılmalıdır. Örnek:

Artık herşey yerli yerine oturduğuna göre aşağıdaki örneği izleyerek Apache ve PHP'yi kurabilirsiniz:

# /etc/init.d/apache2 stop
# /etc/init.d/apache2 start

Yapılandırma üzerinde daha iyi denetim

Bir önceki bölümde PHP sadece çekirdek modüllerle kurulmuştu. Çok geçmeden MySQL, cURL, GD ve benzeri modülleri etkinleştirme ihtiyacı duyabilirsiniz. Bunları da apt komutuyla kurabilirsiniz.

# apt-cache search php
# apt search php | grep -i mysql
# aptitude search php

Bu örnek komutların çıktısından da görebileceğiniz gibi, php-cgi, php-cli ve php-dev gibi özel paketlerde dahil olmak üzere kurabileceğiniz çok sayıda PHP modülü vardır. Listeyi dikkatlice inceleyip ihtiyacınız olanları seçtikten sonra apt veya aptitude ile bunları kurabilirsiniz. Debian bunlar içinde bağımlılık denetimleri yapacağından, örneğin MySQL ve cURL kurmak istediğinizde bunların bağımlı olduğu paketleri de kurmayı teklif edecektir:

# apt install php5-mysql php5-curl

APT otomatik olarak farklı php.ini (/etc/php/7.4/apache2/php.ini, /etc/php/7.4/conf.d/pdo.ini ve benzeri) dosyalarına uygun satırları ve eklentinin türüne bağlı olarak extension=foo.so benzeri girdileri ekleyecektir. Bu değişikliklerin de etkili olabilmesi için Apache2'nin yeniden başlatılması gerekir.

Bilinen sorunlar

• Bir betiğin sonucu yerine betiğin PHP kaynak kodlarını görüyorsanız, Debian muhtemelen /etc/apache2/apache2.conf dosyasına (veya benzeri bir dosyaya) PHP ile ilgili satırları eklememiştir. Bu konu ile ilgili ayrıntılar için Debian kılavuzuna bakınız.
• Eğer bir eklenti tanımlı gibi gözüktüğü halde işlevlerini kullanamıyorsanız ilgili ini dosyasının yüklendiğinden ve Apache2'nin yeniden başlatıldığından emin olmalısınız.
• Debian üzerinde paket kurmak için kullanılabilecek iki temel komut vardır: apt ve aptitude. Bu iki komut arasındaki farklar için dağıtımınızla gelen belgelere bakınız.

PHP Kurulum Araçları

» XAMPP, WampServer ve BitNami, Windows üzerinde Apache ile kullanım için PHP uygulamalarını kuracaktır.

Windows'ta Nginx'i kurmak ve yapılandırmak biraz daha fazla yapılandırma gerektirir. Daha fazala bilgi için bkz: » Nginx belgeleri

OpCache

OpCache'i etkinleştirmeniz önemle tavsiye edilir. Bu eklenti, Windows için PHP'ye dahildir. PHP betiklerini derler, en iyilendirir ve sayfa her yüklendiğinde yeniden derlenmemeleri için onları bellekte önbelleğe alır.

php.ini dosyasında şunu yapın:

opcache.enable=On
opcache.enable_cli=On

WinCache

Özellikle paylaşılan bir web barındırma ortamında IIS kullanılıyorsa veya ağ bağlantılı dosya depolama (NAS) kullanılıyorsa, WinCache kullanılması önerilir. WinCache, PHP 8.0.0'dan itibaren artık desteklenmemektedir.

Tüm PHP Uygulamaları, WinCache dosya önbelleği özelliğinden otomatik olarak yararlanır. Dosya sistemi işlemleri bellekte önbelleğe alınır.

WinCache ayrıca kullanıcı nesnelerini bellekte önbelleğe alabilir ve bunları php.exe veya php-cgi.exe süreçleri arasında paylaşabilir (nesneleri istekler arasında paylaşır).

Birçok büyük http uygulamasının, WinCache kullanıcı nesnesi önbelleğini kullanmak için bir eklenti, uzantı veya yapılandırma seçeneği vardır.

Yüksek başarıma ihtiyacınız varsa uygulamalarınızda nesne önbelleğini kullanmalısınız.

PHP eklentilerini dizininize bir WinCache DLL (veya tgz) indirmek için (php.ini'nizdeki extensions_dir) bkz: » http://pecl.php.net/package/WinCache

php.ini dosyasında şunu yapın:

extension=php_wincache.dll
wincache.fcenabled=1
wincache.ocenabled=1 ; removed as of wincache 2.0.0.0

IIS Yapılandırması

IIS Yöneticisinde, FastCGI modülünü kurun ve PHP-CGI.exe (PHP.exe değil) yoluna `.php` için bir işleyici eşlemi ekleyin.

IIS yapılandırmasını betik olarak oluşturmak için APPCMD komut satırı aracını kullanabilirsiniz.

Veritabanı

Muhtemelen bir Veritabanı Sunucusuna ihtiyacınız olacaktır. Çoğu veritabanının PHP eklentisi vardır. Siteniz çok fazla trafik almıyorsa, veritabanı sunucunuzu http sunucunuzla aynı sunucuda çalıştırabilirsiniz. Birçok veritabanı sunucusu Windows üzerinde çalışır.

PHP, mysqli ve pdo_mysql eklentilerini içerir.

Bkz: » https://dev.mysql.com/downloads/windows/

Web Sunucusunu seçin

@echo off

REM http://windows.php.net/downloads/ adresinden PHP kurulumu için
REM .ZIP dosyasını indirin

REM PHP .ZIP dosyasını açtığınız dizinin yolunu phppath=c:\php
REM (sonda \ yok) olarak ayarlayın

REM Geçerli PHP işleyicilerini temizleyin:
%windir%\system32\inetsrv\appcmd clear config /section:system.webServer/fastCGI

REM PHP kurulu değilse aşağıdaki komut bir hata iletisi üretir.
REM Bu yok sayılabilir.
%windir%\system32\inetsrv\appcmd set config /section:system.webServer/handlers /-[name='PHP_via_FastCGI']

REM PHP işleyicisini ayarlayın
%windir%\system32\inetsrv\appcmd set config /section:system.webServer/fastCGI /+[fullPath='%phppath%\php-cgi.exe']
%windir%\system32\inetsrv\appcmd set config /section:system.webServer/handlers /+[name='PHP_via_FastCGI',path='*.php',verb='*',modules='FastCgiModule',scriptProcessor='%phppath%\php-cgi.exe',resourceType='Unspecified']
%windir%\system32\inetsrv\appcmd set config /section:system.webServer/handlers /accessPolicy:Read,Script

REM FastCGI Değişkenlerini Yapılandırın
%windir%\system32\inetsrv\appcmd set config -section:system.webServer/fastCgi /[fullPath='%phppath%\php-cgi.exe'].instanceMaxRequests:10000
%windir%\system32\inetsrv\appcmd.exe set config -section:system.webServer/fastCgi /+"[fullPath='%phppath%\php-cgi.exe'].environmentVariables.[name='PHP_FCGI_MAX_REQUESTS',value='10000']"
%windir%\system32\inetsrv\appcmd.exe set config -section:system.webServer/fastCgi /+"[fullPath='%phppath%\php-cgi.exe'].environmentVariables.[name='PHPRC',value='%phppath%\php.ini']"

Derlenmiş paket seçimi

PHP'nin Windows derlemeleri » http://windows.php.net/download/ adresinden indirilebilir. Tüm derlemeler (PGO) en iyilenmiş olup QA ve GA sürümleri kapsamlı bir şekilde denenmiştir.

4 tür PHP derlemesi vardır:

• Thread-Safe(TS) - tek süreçli web sunucular için - Apache ve mod_php gibi

• Non-Thread-Safe(NTS) - IIS ve diğer FastCGI web sunucuları için - (Apache ve mod_fastcgi)- komut satırı betikleri için önerilir.

• x86 - 32 bitlik sistemler için

• x64 - 64 bitlik sistemler için

Apache işleyicisi olarak kurulum

Apache 2.x PHP modülünü yüklemek için Apache httpd.conf yapılandırma dosyasına aşağıdaki satırlar eklenmelidir:

# PHP 8.0.0 öncesinde modülün ismi php7_module idi
LoadModule php_module "c:/php/php8apache2_4.dll"
<FilesMatch \.php$>
    SetHandler application/x-httpd-php
</FilesMatch>
# php.ini yolunu yapılandır
PHPIniDir "C:/php"

Bilginize: Yukarıdaki örneklerde C:/php/ yerine PHP'nin gerçek yolu yazılmalıdır. LoadModule yönergesinde başvurulan dosyanın belirtilen konumda olduğundan emin olun. PHP 7 için php7apache2_4.dll, PHP 8 için php8apache2_4.dll kullanın.

PHP'yi CGI olarak çalıştırmak

Apache'de CGI çalıştırmanın daha iyi bir şekilde anlaşılması için » Apache CGI belgelerine başvurmanız şiddetle tavsiye edilir.

PHP'yi CGI olarak çalıştırmak için, php-cgi dosyalarının ScriptAlias yönergesi kullanılarak CGI dizini olarak belirlenmiş bir dizine yerleştirilmesi gerekecektir.

PHP dosyalarının başına PHP çalıştırılabilirinin konumuna işaret eden #! satırının yerleştirilmesi gerekir:

#!C:/php/php.exe
<?php
  phpinfo();
?>

PHP'yi FastCGI altında çalıştırmak

PHP'yi FastCGI altında çalıştırmanın, bir CGI olarak çalıştırmaya göre bir takım getirileri vardır. Bu şekilde ayarlamak oldukça basittir:

mod_fcgid modülünü » https://www.apachelounge.com adresinden edinin. Win32 ikili dosyaları bu siteden indirilebilir. Modülü beraberinde gelen talimatlara göre kurun.

Web sunucunuzu, sisteminize yüklediğiniz yeri belirten dosya yolunu ayarlamaya özen göstererek aşağıda gösterildiği gibi yapılandırın:

LoadModule fcgid_module modules/mod_fcgid.so
# php.ini dosyanızın yeri
FcgidInitialEnv PHPRC        "c:/php"
<FilesMatch \.php$>
    SetHandler fcgid-script
</FilesMatch>
FcgidWrapper "c:/php/php-cgi.exe" .php

Geçici Dizin İzinlerini Kontrol Edin

WinCache

WinCache, Azure Uygulama Hizmetleri üzerinde öntanımlı olarak etkindir ve etkin durumda bırakmanız önerilir. Kendi PHP kurulumunuzu yapmak isterseniz WinCache'yi de etkinleştirmelisiniz.

Özel PHP Kurulumu

Kendi PHP derlemenizi D:\Home (C:\ yazılabilir değildir) dizini altına yükleyebilirsiniz. Ardından Azure Portalında, .php için SCRIPT_PROCESSOR'e yapınızdaki php-cgi.exe dosyasının mutlak yoluna atayın.

Compiling from sources

In order to enable FPM in your PHP build you need to add --enable-fpm to your configure line.

There are several other FPM-specific configure options (all of them optional):

• --with-fpm-user - set FPM user (default - nobody).

• --with-fpm-group - set FPM group (default - nobody).

• --with-fpm-systemd - Activate systemd integration (default - no).

• --with-fpm-acl - Use POSIX Access Control Lists (default - no).

• --with-fpm-apparmor - Activate AppArmor integration (default - no).

• --with-fpm-selinux - Activate SELinux integration (default - no).

Sürüm Bilgisi

List of global php-fpm.conf directives

pid string

Path to PID file. Default value: none.

error_log string

Path to error log file. Default value: #INSTALL_PREFIX#/log/php-fpm.log. If it's set to "syslog", log is sent to syslogd instead of being written in a local file.

log_level string

Error log level. Possible values: alert, error, warning, notice, debug. Default value: notice.

log_limit int

Log limit for the logged lines which allows to log messages longer than 1024 characters without wrapping. Default value: 1024. Available as of PHP 7.3.0.

log_buffering bool

Experimental logging without extra buffering. Default value: yes. Available as of PHP 7.3.0.

syslog.facility string

used to specify what type of program is logging the message. Default value: daemon.

syslog.ident string

Prepended to every message. If you have multiple FPM instances running on the same server, you can change the default value which must suit common needs. Default value: php-fpm.

emergency_restart_threshold int

If this number of child processes exit with SIGSEGV or SIGBUS within the time interval set by emergency_restart_interval, then FPM will restart. A value of 0 means 'Off'. Default value: 0 (Off).

emergency_restart_interval mixed

Interval of time used by emergency_restart_interval to determine when a graceful restart will be initiated. This can be useful to work around accidental corruptions in an accelerator's shared memory. Available Units: s(econds), m(inutes), h(ours), or d(ays). Default Unit: seconds. Default value: 0 (Off).

process_control_timeout mixed

Time limit for child processes to wait for a reaction on signals from master. Available units: s(econds), m(inutes), h(ours), or d(ays) Default Unit: seconds. Default value: 0.

process.max int

The maximum number of processes FPM will fork. This has been design to control the global number of processes when using dynamic PM within a lot of pools. Use it with caution. Default value: 0.

process.priority int

Specify the nice(2) priority to apply to the master process (only if set). The value can vary from -19 (highest priority) to 20 (lower priority). Default value: not set.

daemonize bool

Send FPM to background. Set to 'no' to keep FPM in foreground for debugging. Default value: yes.

rlimit_files int

Set open file descriptor rlimit for the master process. Default value: system defined value.

rlimit_core int

Set max core size rlimit for the master process. Default value: 0.

events.mechanism string

Specify the event mechanism FPM will use. The following is available: select, pool, epoll, kqueue (*BSD), port (Solaris). Default value: not set (auto detection).

systemd_interval int

When FPM is build with systemd integration, specify the interval, in second, between health report notification to systemd. Set to 0 to disable. Default value: 10.

List of pool directives

With FPM you can run several pools of processes with different setting. These are settings that can be tweaked per pool.

listen string

The address on which to accept FastCGI requests. Valid syntaxes are: 'ip.add.re.ss:port', 'port', '/path/to/unix/socket'. This option is mandatory for each pool.

listen.backlog int

Set listen(2) backlog. A value of -1 means maximum on BSD systems. Default value: -1 (FreeBSD or OpenBSD) or 511 (Linux and other platforms).

listen.allowed_clients string

List of IPv4 or IPv6 addresses of FastCGI clients which are allowed to connect. Equivalent to the FCGI_WEB_SERVER_ADDRS environment variable in the original PHP FastCGI (5.2.2+). Makes sense only with a tcp listening socket. Each address must be separated by a comma. If this value is left blank, connections will be accepted from any ip address. Default value: not set (any ip address accepted).

listen.owner string

Set permissions for unix socket, if one is used. In Linux, read/write permissions must be set in order to allow connections from a web server. Many BSD-derived systems allow connections regardless of permissions. Default values: user and group are set as the running user, mode is set to 0660.

listen.group string

See listen.owner.

listen.mode string

See listen.owner.

listen.acl_users string

When POSIX Access Control Lists are supported you can set them using this option. When set, listen.owner and listen.group are ignored. Value is a comma separated list of user names.

listen.acl_groups string

See listen.acl_users. Value is a comma separated list of group names.

user string

Unix user of FPM processes. This option is mandatory.

group string

Unix group of FPM processes. If not set, the default user's group is used.

pm string

Choose how the process manager will control the number of child processes. Possible values: static, ondemand, dynamic. This option is mandatory.

static - the number of child processes is fixed (pm.max_children).

ondemand - the processes spawn on demand (when requested, as opposed to dynamic, where pm.start_servers are started when the service is started.

dynamic - the number of child processes is set dynamically based on the following directives: pm.max_children, pm.start_servers, pm.min_spare_servers, pm.max_spare_servers.

pm.max_children int

The number of child processes to be created when pm is set to static and the maximum number of child processes to be created when pm is set to dynamic. This option is mandatory.

This option sets the limit on the number of simultaneous requests that will be served. Equivalent to the ApacheMaxClients directive with mpm_prefork and to the PHP_FCGI_CHILDREN environment variable in the original PHP FastCGI.

pm.start_servers int

The number of child processes created on startup. Used only when pm is set to dynamic. Default Value: min_spare_servers + (max_spare_servers - min_spare_servers) / 2.

pm.min_spare_servers int

The desired minimum number of idle server processes. Used only when pm is set to dynamic. Also mandatory in this case.

pm.max_spare_servers int

The desired maximum number of idle server processes. Used only when pm is set to dynamic. Also mandatory in this case.

pm.max_spawn_rate int

The number of rate to spawn child processes at once. Used only when pm is set to dynamic. Default value: 32

pm.process_idle_timeout mixed

The number of seconds after which an idle process will be killed. Used only when pm is set to ondemand. Available units: s(econds)(default), m(inutes), h(ours), or d(ays). Default value: 10s.

pm.max_requests int

The number of requests each child process should execute before respawning. This can be useful to work around memory leaks in 3rd party libraries. For endless request processing specify '0'. Equivalent to PHP_FCGI_MAX_REQUESTS. Default value: 0.

pm.status_listen string

The address on which to accept FastCGI status request. This creates a new invisible pool that can handle requests independently. This is useful if the main pool is busy with long running requests because it is still possible to get the FPM status page before finishing the long running requests. The syntax is the same as for listen directive. Default value: none.

pm.status_path string

The URI to view the FPM status page. This value must start with a leading slash (/). If this value is not set, no URI will be recognized as a status page. Default value: none.

ping.path string

The ping URI to call the monitoring page of FPM. If this value is not set, no URI will be recognized as a ping page. This could be used to test from outside that FPM is alive and responding. Please note that the value must start with a leading slash (/).

ping.response string

This directive may be used to customize the response to a ping request. The response is formatted as text/plain with a 200 response code. Default value: pong.

process.priority int

Specify the nice(2) priority to apply to the worker process (only if set). The value can vary from -19 (highest priority) to 20 (lower priority). Default value: not set.

process.dumpable bool

Set the process dumpable flag (PR_SET_DUMPABLE prctl) even if the process user or group is different than the master process user. It allows to create process core dump and ptrace the process for the pool user. Default Value: no. Since PHP 7.0.29, 7.1.17 and 7.2.5.

prefix string

Specify prefix for path evaluation

request_terminate_timeout mixed

The timeout for serving a single request after which the worker process will be killed. This option should be used when the 'max_execution_time' ini option does not stop script execution for some reason. A value of '0' means 'Off'. Available units: s(econds)(default), m(inutes), h(ours), or d(ays). Default value: 0.

request_terminate_timeout_track_finished bool

The timeout set by request_terminate_timeout is not engaged after a fastcgi_finish_request or when application has finished and internal shutdown functions are being called. This directive will enable timeout limit to be applied unconditionally even in such cases. Default value: no. Since PHP 7.3.0.

request_slowlog_timeout mixed

The timeout for serving a single request after which a PHP backtrace will be dumped to the 'slowlog' file. A value of '0' means 'Off'. Available units: s(econds)(default), m(inutes), h(ours), or d(ays). Default value: 0.

request_slowlog_trace_depth int

The depth of slowlog log stack trace. Default value: 20. Since PHP 7.2.0.

slowlog string

The log file for slow requests. Default value: #INSTALL_PREFIX#/log/php-fpm.log.slow.

rlimit_files int

Set open file descriptor rlimit for child processes in this pool. Default value: system defined value.

rlimit_core int

Set max core size rlimit for child processes in this pool. Possible Values: 'unlimited' or an integer greater or equal to 0. Default value: system defined value.

chroot string

Chroot to this directory at the start. This value must be defined as an absolute path. When this value is not set, chroot is not used.

chdir string

Chdir to this directory at the start. This value must be an absolute path. Default value: current directory or / when chroot.

catch_workers_output bool

Redirect worker stdout and stderr into main error log. If not set, stdout and stderr will be redirected to /dev/null according to FastCGI specs. Default value: no.

decorate_workers_output bool

Enable the output decoration for workers output when catch_workers_output is enabled. Default value: yes. Available as of PHP 7.3.0.

clear_env bool

Clear environment in FPM workers. Prevents arbitrary environment variables from reaching FPM worker processes by clearing the environment in workers before env vars specified in this pool configuration are added. Default value: Yes.

security.limit_extensions string

Limits the extensions of the main script FPM will allow to parse. This can prevent configuration mistakes on the web server side. You should only limit FPM to .php extensions to prevent malicious users to use other extensions to execute php code. Default value: .php .phar

apparmor_hat string

If AppArmor is enabled, it allows to change a hat. Default value: not set

access.log string

The access log file. Default value: not set

access.format string

The access log format. Default value: "%R - %u %t \"%m %r\" %s":

Valid options

Placeholder	Description
%C	%CPU
%d	duration µs
%e	fastcgi env
%f	script
%l	content length
%m	method
%M	memory
%n	pool name
%o	header output
%p	PID
%q	query string
%Q	the glue between %q and %r
%r	request URI
%R	remote IP address
%s	status
%T	time
%t	time
%u	remote user

It's possible to pass additional environment variables and update PHP settings of a certain pool. To do this, you need to add the following options to the pool configuration file.

env[HOSTNAME] = $HOSTNAME
env[PATH] = /usr/local/bin:/usr/bin:/bin
env[TMP] = /tmp
env[TMPDIR] = /tmp
env[TEMP] = /tmp

php_admin_value[sendmail_path] = /usr/sbin/sendmail -t -i -f www@my.domain.com
php_flag[display_errors] = off
php_admin_value[error_log] = /var/log/fpm-php.www.log
php_admin_flag[log_errors] = on
php_admin_value[memory_limit] = 32M

Settings defined with php_admin_value and php_admin_flag cannot be overridden with ini_set().

PHP settings can be set in the webserver configuration.

set $php_value "pcre.backtrack_limit=424242";
set $php_value "$php_value \n pcre.recursion_limit=99999";
fastcgi_param  PHP_VALUE $php_value;

fastcgi_param  PHP_ADMIN_VALUE "open_basedir=/var/www/htdocs";

Bilginize: Pools are not a security mechanism, because they do not provide full separation; e.g. all pools would use a single OPcache instance.

Bir eklenti nereden bulunur?

PHP eklentileri genellikle php_*.dll biçeminde isimlendirilir (yıldız iminin yerine eklentinin ismi gelir) ve PHP\ext dizini altında bulunur.

PHP, geliştiricilerin büyük çoğunluğunca en faydalı bulunan eklentilerle birlikte gelir. Bu tür paketlere toplu paket adı verilir.

Bununla birlikte, çekirdek eklentilerle sağlanmamış bir işlevselliğe ihtiyaç duyulursa, bunları edinmek için » PECL sitesinde bulunabilir. PHP Eklentileri Halk Kütüphanesi (PECL - PHP Extension Community Library) bir PHP Eklentileri deposu olup PHP eklentilerinin geliştirilmesi ve indirilmesi için barındırma oluşumlarını ve bilinen tüm eklentilerin bir dizinini içerir.

Kendi kullanımı için eklenti geliştirenler bu eklentinin PECL'de barındırılmasını isteyebilir, böylece ihtiyaçları aynı olan başkaları da bu eklentiden yararlanabilir. Bunun bazı olumlu yan etkileri de vardır: Geribildirim, teşekkür, hata bildirimi, hatta düzeltme ve yama alma şansı olur. Eklentiyi barındırılmak üzere PECL'ye göndermeden önce » PECL adresinin incelenmesi önerilir.

Hangi eklenti indirilecek?

Çoğu zaman her DLL'nin çok sayıda sürümü vardır:

• Farklı sürüm numaraları (en azından ilk iki sayı tutmalı)
• Farklı evre güvenceli olanlar
• Farklı işlemciler için olanlar (x86, x64, ...)
• Farklı hata ayıklama seçenekli olanlar
• vs.

Şuna da dikkat edilmelidir: Eklenti ayarları kullanılan PHP çalıştırılabilirinin ayarları ile aynı olmalıdır. Aşağıdaki PHP betiği PHP ayarlarının tamamını içerecektir:

Ya da komut satırından:

sürücü:\dizin\yolu\php\executable\php.exe -i

Bir eklentinin yüklenmesi

Bir PHP eklentisini yüklemenin en bilinen yolu eklentiyi php.ini dosyasına eklemektir. Dikkatle incelenirse php.ini dosyasında bir çok eklentinin zaten ekli olduğunu görülür. Eklentiyi etkin kılmak için yapılacak tek değişiklik eklentinin belirtildiği satırın başındaki noktalı virgülü silmek olacaktır.

PHP 7.2.0 ve üzeri sürümlerde, eklentinin dosya adı yerine eklenti adı da kullanılabilir. Bu işletim sisteminden bağımsız ve daha kolay olduğundan, özellikle yeni başlayanlar için, yüklenecek eklentileri belirlemenin önerilen yolu haline gelir. Dosya adları, önceki sürümlerle uyumluluk için desteklenmeye devam etmektedir.

;extension=php_eklenti.dll

extension=php_eklenti.dll

; PHP 7.2 ve sonrasında önerilen:
extension=eklenti
zend_extension=diğer_eklenti

Bununla birlikte, bazı HTTP sunucuları, PHP çalıştırılabilirinin yanına konmuş php.ini dosyasını kullanmadıklarından eklentiyi göremeyebilir. HTTP sunucusunun kullandığı php.ini dosyasının bulunduğu yer phpinfo() işlevi kullanılarak şöyle öğrenilebilir:

Configuration File (php.ini) Path C:\WINDOWS

Loaded Configuration File         C:\Program Files\PHP\8.2\php.ini

Eklentiyi etkin kıldıktan sonra php.ini dosyası kaydedilmeli ve HTTP sunucusu yeniden başlatıldıktan sonra tekrar phpinfo() çıktısına bakılmalıdır. Yeni eklentinin artık kendi bölümünde görünüyor olması gerekir.

Sorunların çözümlenmesi

Eğer eklenti phpinfo() çıktısında görünmüyorsa sorunun kaynağını bulmak için günlük dosyalarına bakılmalıdır.

PHP, komut satırından kullanılıyorsa (CGI), eklenti yükleme hatası doğrudan ekranda görülebilir.

PHP bir HTTP sunucusu ile kullanılıyorsa günlük dosyalarının yeri ve biçemi kullanılan yazılıma göre değişir. Günlüklerin yerini bulmak için kullanılan HTTP sunucusunun belgelerine bakılmalıdır.

Sorunların çoğu DLL dosyasının ve bu dosyanın bağımlı olduğu DLL'lerin yeri ile ilgilidir. php.ini içindeki "extension_dir" yönergesinin değeri ile derleme sırasında yapılan ayarlar arasında bir tutarsızlık olabilir.

Eğer sorun derleme sırasında yapılan ayarlarla uyumsuzluktan kaynaklanıyorsa muhtemelen indirilen DLL dosyası doğru yere konulmamış demektir. Eklentinin doğru ayarlarla tekrar indirilmesi gerekebilir. Bu yapıldıktan sonra phpinfo() çıktısının tekrar incelenmesi uygun olacaktır.

Tarama Dizinleri

PHP'yi, php.ini'yi okuduktan sonra bir dizindeki .ini dosyalarını tarayacak şekilde yapılandırmak mümkündür. Bu, --with-config-file-scan-dir seçeneği ayarlanarak derleme sırasında yapılabilir. Tarama dizini daha sonra çalışma anında PHP_INI_SCAN_DIR ortam değişkeni ayarlanarak geçersiz kılınabilir.

Birden fazla dizini platforma özgü yol ayırıcıyla ayırarak taramak mümkündür (Windows, NetWare ve RISC OS için ; diğer tüm platformlarda : kullanılır. PHP'nin kullandığı değer PATH_SEPARATOR sabiti olarak mevcuttur). PHP_INI_SCAN_DIR'de boş bir dizin verilmişse, PHP ayrıca derleme sırasında --with-config-file-scan-dir seçeneği ile verilen dizini de tarayacaktır.

PHP her dizinde, PHP .ini uzantılı tüm dosyaları alfabetik sırayla tarar. php_ini_scanned_files() işlevi ile veya PHP'yi --ini seçeneğiyle çalıştırarak yüklenen dosyaların bir listesi ve sırası elde edilebilir.

PHP'nin --with-config-file-scan-dir=/etc/php.d ile yapılandırıldığını
ve yol ayırıcının : olduğunu varsayalım ...

$ php
  PHP /etc/php.d/*.ini dosyalarının tamamını
  yapılandırma dosyaları olarak yükler

$ PHP_INI_SCAN_DIR=/usr/local/etc/php.d php
  PHP /usr/local/etc/php.d/*.ini dosyalarının tamamını
  yapılandırma dosyaları olarak yükler

$ PHP_INI_SCAN_DIR=:/usr/local/etc/php.d php
  PHP /etc/php.d/*.ini ve ardından /usr/local/etc/php.d/*.ini
  dosyalarının tamamını yapılandırma dosyaları olarak yükler

$ PHP_INI_SCAN_DIR=/usr/local/etc/php.d: php
  PHP /usr/local/etc/php.d/*.ini ve ardından /etc/php.d/*.ini
  dosyalarının tamamını yapılandırma dosyaları olarak yükler

PHP'nin bir Apache modülü olarak çalıştırılması

PHP'yi bir Apache modülü olarak kullanırken, yapılandırma ayarlarını Apache yapılandırma dosyalarındaki (httpd.conf ve .htaccess dosyaları) yönergeleri kullanarak da değiştirebilirsiniz. Bunu yapabilmek için Apache yapılandırmasında "AllowOverride Options" veya "AllowOverride All" olması gerekir.

PHP yapılandırmasını Apache yapılandırma dosyaları içinden değiştirmenize imkan veren çeşitli Apache yönergeleri vardır. INI_ALL, INI_PERDIR veya INI_SYSTEM olarak belirtilebilen yönergeleri eklerdeki php.ini yönergelerinin listesi sayfasında bulabilirsiniz.

php_value isim değer

Belirtilen değeri ismi belirtilen yönergeye atar. Sadece INI_ALL ve INI_PERDIR türü yönergeler için kullanılabilir. Önceki atanan değeri silmek için değer olarak none kullanın.

Bilginize: Mantıksal değer atamak için php_value yönergesini değil, php_flag (aşağıya bakınız) yönergesini kullanmalısınız.

php_flag isim on|off

Bir mantıksal yapılandırma yönergesi atamak için kullanılır. Sadece INI_ALL ve INI_PERDIR türü yönergeler için kullanılabilir.

php_admin_value isim değer

İsmi belirtilen yönergeye belirtilen değeri atar. .htaccess dosyalarında kullanılamaz. Bu yönerge ile atanan hiçbir yönerge türü ini_set() veya .htaccess tarafından geçersiz kılınamaz. Önceki atanan değeri silmek için değer olarak none kullanın.

php_admin_flag isim on|off

Bir mantıksal yapılandırma yönergesi atamak için kullanılır. .htaccess dosyalarında kullanılamaz. Bu yönerge ile atanan hiçbir yönerge türü .htaccess veya ini_set() tarafından geçersiz kılınamaz.

<IfModule mod_php5.c>
  php_value include_path ".:/usr/local/lib/php"
  php_admin_flag engine on
</IfModule>
<IfModule mod_php4.c>
  php_value include_path ".:/usr/local/lib/php"
  php_admin_flag engine on
</IfModule>

PHP yapılandırmasının Windows kayıt defteri üzerinden değiştirilmesi

PHP, Windows üzerinde çalışırken, yapılandırma değerleri Windows kayıt defteri kullanılarak her dizin için ayrı ayrı değiştirilebilir. Yapılandırma değerleri defterde HKLM\SOFTWARE\PHP\Per Directory Values anahtarının dizin isimlerine karşılık gelen alt anahtarlarında saklanır. Örneğin, c:\inetpub\wwwroot dizini için yapılandırma değerleri HKLM\SOFTWARE\PHP\Per Directory Values\c\inetpub\wwwroot anahtarında saklanır. Dizin ile ilgili ayarlar, dizin içinde ve alt dizinlerde çalıştırılan her betik için geçerli olur. Anahtar altındaki değerler PHP yapılandırma yönergelerinin isimlerini ve dizge değerlerini içermelidir. Değerlerde bulunan PHP sabitleri çözümlenmez. Sadece, INI_USER türü değişebilir yapılandırma değerleri bu yolla atanabilir, INI_PERDIR değerleri atanamaz, çünkü bu yapılandırma değerleri her istekte yeniden okunur.

Diğer PHP arayüzleri

PHP'yi nasıl çalıştırdığınızdan bağımsız olarak, belli değerleri betiğinizin çalışması sırasında ini_set() işlevi sayesinde değiştirebilirsiniz. Bu konuda daha ayrıntılı bilgi için ini_set() sayfasına bakınız.

Sistem yapılandırmanızla ilgili ayarlar ve mevcut değerleri ilginizi çekiyorsa phpinfo() işlevini çalıştırabilir ve elde ettiğiniz sayfayı inceleyebilirsiniz. Ayrıca, yapılandırma yönergelerinin her birine çalışma anında ini_get() veya get_cfg_var() işlevini kullanarak erişebilirsiniz.

Temel türler

Bazı temel türler, dille sıkı bir şekilde bütünleşmiş yerleşik türler olup kullanıcı tanımlı türlerle yeniden türetilemez.

Temel türler:

• Yerleşik türler
  • null türü
  • Sayıl türler:
    • bool türü
    • int türü
    • float türü
    • string türü
  • array türü
  • object türü
  • resource türü
  • never türü
  • void türü
  • Göreli sınıf türleri: self, parent, static
• Kendisi tür olanlar
  • false
  • true
• Kullanıcı tanımlı türler (genelde sınıf türleri olarak bilinir)
  • Arayüzler
  • Sınıflar
  • Sayılamalar
• callable türü

Birleşim türleri

Temel türleri birleşik türler halinde birleştirmek mümkündür. PHP, türlerin aşağıdaki şekillerde birleştirilmesine izin verir:

• Sınıf türlerinin (arayüz ve sınıf isimlerinin) kesişimi.
• Tür birleşimleri.

Tür takma adları

PHP iki tür-takma-adı destekler: object|resource|array|string|float|int|bool|null karşılığı olarak mixed ve Traversable|array karşılığı olarak iterable.

Bilginize: PHP kullanıcı tanımlı tür takma adlarını desteklemez.

Sözdizimi

null türünde, harf büyüklüğüne duyarsız tek bir sabit vardır: null.

null türüne çarpıtım

(unset) $var kullanarak bir değişken null türüne çarpıtılırsa değişken kaldırılmaz fakat değersiz hale getirilmiş olur ve sadece null değer döndürür.

Ayrıca Bakınız

• is_null()
• unset()

Sözdizimi

Bir bool sayılını belirtmek için true veya false sabiti kullanılır. Her ikisi de harf büyüklüğüne duyarsızdır.

Genelde, bool türünde bir değer döndüren bir işleç ifadesinin sonucu bir denetim yapısına aktarılır.

bool türüne dönüşüm

Bir değeri doğrudan bool türüne dönüştürmek için (bool) çarpıtması kullanılabilir. Genelde bu gereksizdir, çünkü mantıksal bir bağlamda kullanılan bir değer otomatik olarak bool türünde bir değer olarak yorumlanır. Daha ayrıntılı bilgi için Tür Dönüşümü sayfasına bakılabilir.

Ayrıca, Tür Dönüşümü bölümüne de bakınız.

Aşağıdaki değerler bool türüne dönüşümde false olarak ele alınırlar:

• mantıksal false (kendisi)
• tamsayı 0 (sıfır)
• gerçel 0.0 ve -0.0 (sıfır)
• boş dizge "" ve dizgesel "0"
• hiç elemanı olmayan dizi
• tür olarak NULL (tanımsız değişkenler dahil)
• bool türüne dönüşmek için (bool) çarpıtmasını aşırı yükleyen dahili nesneler. Örneğin, SimpleXML nesneleri özniteliksiz boş elemanlardan oluşturulur.

Bunların dışında kalan tüm değerler true olarak ele alınır (resource türler ve NAN dahil).

Ayrıca Bakınız

• Kayan noktalı sayılar
• Keyfi ondalık hassasiyet / BCMath
• Keyfi uzunlukta tamsayı / GMP

Sözdizimi

int türünde değerler onluk, sekizlik veya onaltılık tabanda belirtilebilirler. değil işleci negatif bir int belirtmekte kullanılabilir.

Sekizlik gösterimde sayıların önüne 0 (sıfır), onaltılık gösterimde 0x ve ikil gösterimde 0b getirilir. PHP 8.1.0 ve sonrasında sekizlik gösterim ayrıca, 0o veya 0O ile öncelenmiş de olabilir.

PHP 7.4.0'dan itibaren, tamsayı değişmezleri, değişmez değerlerin daha iyi okunabilirliği için rakamlar arasında alt çizgi (_) içerebilir. Bu alt çizgiler PHP'nin tarayıcısı tarafından kaldırılır.

PHP 8.1.0'dan itibaren, biçimsel olarak, int değişmezlerinin yapısı (evvelce, 0o ve 0O sekizlik öneklerine ve PHP 7.4.0'dan önce alt çizgilere izin verilmezdi):

onluk     : [1-9][0-9]*(_[0-9]+)*
          | 0

onaltılık : 0[xX][0-9a-fA-F]+(_[0-9a-fA-F]+)*

sekizlik  : 0[oO]?[0-7]+(_[0-7]+)*

ikil      : 0[bB][01]+(_[01]+)*

tamsayı   : onluk
          | onaltılık
          | sekizlik
          | ikil

Bir intr türün genişliği platforma göre değişir. 32 bitlik sistemlerde azami değer 2 milyon civarında iken 64 bitlik sistemlerde 9E18 civarındadır. PHP işaretsiz tamsayıları (C'deki unsigned) desteklemez. int türün genişliği PHP_INT_SIZE sabitine, olası en büyük değeri PHP_INT_MAX sabitine ve en küçük değeri ise PHP_INT_MIN sabitine atanmıştır.

Tamsayılarda taşma

PHP, int türünde bir değerin bellekte int türüne ayrılan genişliğe sığmadığını saptarsa float türünde bir değer olarak ele alır ve bu durum yapılan bir işlem sırasında ortaya çıkmışsa işlemden dönen değer float türünde olur.

PHP'de sonucun int türünde elde edileceği bir bölme işleci mevcut değildir, bunu sağlamak için intdiv() işlevini kullanın. 1/2 işleminin sonucu float türünde 0.5 değeridir. Bu değer (int) ile çarpıtılarak sıfıra yuvarlamak suretiyle bir tamsayıya dönüştürülebilirse de round() işlevini kullanırsanız dönüşümün nasıl yapılacağını kendiniz belirleyebilirsiniz.

int türüne dönüşüm

Bir değeri doğrudan int türüne dönüştürmek için (int) veya (integer) çarpıtmasını kullanabilirsiniz. Ancak, çoğu durumda türü çarpıtmak gerekmez, bir int değer gerektiren bir işlev veya denetim yapısı, değeri kendiliğinden int türüne dönüştürecektir. Ayrıca, bir değer int türüne intval() işleviyle de dönüştürülebilir.

Bir resource bir inte sayıya dönüştürülürse, sonuç, PHP tarafından çalışma anında özkaynağa atanan eşsiz özkaynak numarası olacaktır.

Ayrıca, Tür Dönüşümü bölümüne de bakınız.

float türüne dönüşüm

Kayan noktalı sayıların karşılaştırılması

Yukarıdaki uyarıda kısaca değinildiği gibi kayan noktalı sayılar arasında eşitlik karşılaştırmaları, bunların dahili gösterimlerinden dolayı biraz sorunludur. Bununla birlikte, bu sınırlamaların aşılmasını ve kayan noktalı sayılar arasında karşılaştırma yapılmasını sağlayan yollar vardır.

Kayan noktalı değerlerin eşitliğini sınamak için yuvarlamadan dolayı ortaya çıkan göreli hatanın bir üst sınırı kullanılır. Bu değer makine epsilonu veya yuvarlama birimi olarak bilinir ve hesaplamalardaki kabul edilebilir en küçük farktır.

NaN

Bazı sayısal işlemler NAN sabiti ile gösterilen bir değerle sonuçlanabilir. Bu sonuç, kayan noktalı hesaplamalarda tanımlanamayan veya gösterilemeyen bir değeri gösterir. Bu değerin, kendisi dahil herhangi bir değerle gevşek ya da sıkı bir karşılaştırması false sonucuna sebep olur.

NAN farklı değerdeki herhangi bir sayıyı temsil ettiğinden kendisi dahil fakat true hariç, başka bir değerle karşılaştırılmamalı, bunun yerine değer is_nan() ile sınanmalıdır.

Sözdizimi

string türünde bir sayıl dört şekilde belirtilebilir:

• tek tırnaklı dize
• çift tırnaklı dize
• yorumlu metin (heredoc)
• yorumsuz metin (nowdoc)

      a
     b
    c

  a
 b
c

PHP Parse error:  Invalid body indentation level (expecting an indentation level of at least 3) in example.php on line 4

PHP Parse error:  Invalid indentation - tabs and spaces cannot be mixed in example.php line 8

array(2) {
  [0] =>
  string(11) "a
  b
    c"
  [1] =>
  string(5) "d e f"
}

PHP Parse error:  syntax error, unexpected identifier "ING", expecting "]" in example.php on line 6

Adım "Kimimben" ve işim Foo basmak.
Şimdi Bar2 basıyorum.
Bu büyük 'A' basmalı: A

Yorumlu metin sözdizimi kullanılarak çok sayıda satıra bölünmüş
dize örneği. Tersbölüler daima birebir ele alınır,
örn, \\ and \'

İsmim "$name" ve işim $foo->foo basmak.
Artık {$foo->bar[1]} basıyorum.
Bu büyük 'A' basmalı: \x41

He drank some apple juice.
He drank some juice made of .
He drank some juice made of apples.

He drank some apple juice.
He drank some orange juice.
He drank some purple juice.
John Smith drank some apple juice.
John Smith then said hello to Jane Smith.
John Smith's wife greeted Robert Paulsen.
Robert Paulsen greeted the two .

The character at index -2 is n.
Changing the character at index -3 to o gives strong.

 I am bar.
 I am bar.

string(1) "b"
bool(true)

Warning: Illegal string offset '1.0' in /tmp/t.php on line 7
string(1) "b"
bool(false)

Warning: Illegal string offset 'x' in /tmp/t.php on line 9
string(1) "a"
bool(false)
string(1) "b"
bool(false)

Kullanışlı işlevler ve işleçler

Dizgeler '.' (nokta) işleci kullanılarak ardarda eklenebilir. '+' (toplama) işlecinin bu amaçla kullanımının yararsız oluşuna dikkat ediniz. Daha ayrıntılı bilgi edinmek için Dizge İşleçleri belgesine bakınız.

Dizgelerde değişiklik yapmak için çok sayıda yararlı işlev mevcuttur.

Genel işlevler için Dize İşlevlerine, ileri düzey bul ve değiştir işlevselliği için Perl uyumlu düzenli ifade işlevlerine bakınız.

Ayrıca, URL dizeleri için işlevler ve dizeleri şifrelemek veya şifrelerini çözmek için Sodium ve Hash işlevleri vardır.

Son olarak, karakter türü işlevlerine de bakabilirsiniz.

Dizgeye dönüşüm

Bir değer bir dizeye (string) tür çarpıtması veya strval() işleviyle dönüştürülür. Bir dizenin gerekli olduğu ifade bağlamlarında dizeye dönüşüm otomatik olarak gerçekleşir. Bu genellikle, echo veya print işlevleri kullanılırken veya bir değişken bir dize ile karşılaştırılırken gerçekleşir. Aşağıdakilere, Türler ve Tür Dönüşümü bölümlerinde daha ayrıntılı değinilmiştir. Ayrıca, settype() işlevine de bakabilirsiniz.

bool türündeki true değeri string türündeki "1" değerine dönüştürülür. bool türündeki false değeri string türündeki "" değerine (boş dizeye) dönüştürülür. Bu şekilde, bool ve string değerler arasında her iki yönde de dönüşüm yapılabilmektedir.

integer veya float türünde bir değerin string türüne dönüşümü sayının dizesel gösterimiyle (üstel gösterim dahil) sonuçlanır. Kayan noktalı sayılar üstel gösterim kullanılarak dönüştürülebilir (4.1E+6 gibi).

Bilginize:

PHP 8.0.0 itibariyle, ondalık nokta karakteri daima noktadır ("."). PHP 8.0.0 öncesinde betiğin çalıştığı yerele (LC_NUMERIC) özgüdür. Bakınız: setlocale() işlevi.

Diziler daima "Array" dizesine dönüştürülür; bundan dolayı echo ve print bir dizinin içeriğini kendiliklerinden gösteremezler. Tek bir dizi elemanını görüntüleyebilmek için echo $arr['foo'] gibi bir oluşum kullanınız. İçeriğin tamamının görüntülenebilmesiyle ilgili ipuçları için aşağıya bakınız.

object türleri string türüne dönüştürmek için __toString sihirli yöntemi kullanılmalıdır.

resource türler daima "Resource id #1" benzeri bir dizeye dönüştürülürler; buradaki 1, özkaynağa PHP tarafından çalışma anında atanan eşsiz bir sayıdır. Bu dizenin tam yapısı değişikliğe konu olduğundan güvenilmemelidir ve değişime tabi tutulmalıdır. Çalıştırılan bir betiğin (bir sayfa isteği veya CLI işlemi) ömrü boyunca, belirli bir özkaynak için daima benzersiz olacak ve yeniden kullanılabilir olmayacaktır. Özkaynağın türünü öğrenmek için get_resource_type() işlevini kullanınız.

null daima boş bir dizeye dönüştürülür.

Yukarıda bahsedildiği gibi, bir diziyi, nesneyi veya özkaynağı doğrudan dönüştürmek, bunların değerleri hakkında işe yarar hiçbir bilgi sağlamaz. Bu tür içerikleri daha verimli şekilde incelemek isterseniz print_r() ve var_dump() işlevlerine bakınız.

Çoğu PHP değeri kalıcı olarak saklamak amacıyla dizelere dönüştürülebilir. Bu yönteme dizeleştirme adı verilir ve serialize() işlevi tarafından gerçekleştirilir.

String Türü ve Ayrıntılar

PHP'de string türü bir bayt dizisi ve tampon uzumlığunu belirten bir tamsayı olarak gerçeklenmiştir. Bu baytların nasıl karakterlere dönüştüğü hakkında bir bilgiye sahip değildir, bu görev yazılımcıya bırakılmıştır. Bir dizeyi oluşturan değerlerle ilgili bir sınırlama yoktur. Özellikle 0 değerli baytlara (NUL baytlar) dizenin her yerinde izin verilir. (Bununla birlikte, bu kılavuzda "ikil olarak güvenli" olmadığı belirtilen bir kaç işlev, dizeleri, NULL baytından sonra verileri yok sayan kitaplıklara dağıtabilir.)

string türünün bu doğası, PHP'de neden ayrı bir bayt türünün olmadığını açıklar; bu rolü dizeler üstlenir. Örneğin metin veri döndürmeyen işlevler, ham veriyi bir ağ soketinden okuyup yine de dize döndürecektir.

PHP dizelere belli bir karakter kodlaması dayatmaz, dizelerin nasıl baytlara dönüştüğü merak edilebilir. Örneğin, "á" dizesi "\xE1" (ISO-8859-1), "\xC3\xA1" (UTF-8, C form), "\x61\xCC\x81" (UTF-8, D form) olarak mı yoksa olası başka bir gösterime göre mi kodlanacak? Bunun yanıtı, betiğin karakter kodlaması neyse ona göre karakterler kodlanır, olacaktır. Bu bakımdan, betik örneğin ISO-8859-1'de yazılmışsa dize de ISO-8859-1'de kodlanacaktır. Ancak, Zend Çokbaytlılık etkinse bu uygulanmaz; bu durumda betik keyfi bir kodlamada (açıkça belirtilmiş veya algılanmış olabilir) yazılabilir ve ardından belli bir dahili kodlamaya (dizeler için kullanılacak kodlama) dönüştürülebilir. Betiğin kodlanmasında (veya dahili kodlamada, Zend Çokbaytlılık etkin olmalıdır) bazı kısıtlamalar olduğunu unutmayın. Bu hemen hemen her zaman, bu kodlamanın UTF-8 veya ISO-8859-1 gibi ASCII'nin uyumlu bir üst kümesi olması gerektiği anlamına gelir. Bununla birlikte, büyük/küçük harf durumlarında aynı bayt değerlerinin kullanılabildiği durum bağımlı kodlamaların sorunlu olabileceğini unutmayın.

Şüphesiz, kullanışlı olmak noktasında, metinler üzerinde çalışan işlevler dizenin nasıl kodlanacağına ilşkin bazı varsayımlarda bulunabilir. Ne yazık ki, işlevler arasında bu konuda çok farklı varsayımlar mevcuttur:

• Bazı işlevler dizenin tek baytlı bir kodlamayla kodlanacağını varsayar, fakat bu baytları belli karakterlere yorumlama gereği duymazlar. substr(), strpos(), strlen() ve strcmp() işlevleri bu durumdadır. Bu işlevlerin bellek tamponlarında, yani baytlar ve bayt adresleriyle çalıştıkları için böyle oldukları düşünülebilir.
• Diğer bir işlev grubu, dizgenin kodlamasının aktarıldığını ya da bir öntanımlı kodlamanın olduğunu varsayar. mbstring eklentisindeki işlevler ve htmlentities() böyledir.
• Bir başka işlev grubu geçerli yereli kullanır (bak setlocale()), fakat bayt bayt çalışır.
• Son grup, dizenin belli bir kodlamayı, normal olarak UTF-8 kullandığını varsayar. intl ve PCRE eklentilerindeki işlevlerin çoğu böyledir (PCRE eklentilerindeki işlevlerde sadece u değiştircisi kullanıldığında).

Sonuç olarak, Unicode kullanarak doğru programların yazılması, çalışmayan ve büyük olasılıkla verileri bozacak işlevlerden itinayla kaçınmaya ve bunun yerine doğru davranan, genellikle intl ve mbstring eklentilerindeki işlevleri kullanmaya bağlıdır. Bununla birlikte, Unicode kodlamaları işleyebilen işlevleri kullanmak sadece başlangıçtır. Dilin sağladığı işlevler ne olursa olsun, asıl olan Unicode belirtimini bilmektir. Örneğin, sadece büyük ve küçük harfler olduğunu varsayan bir yazılım yanlış kabul yapıyor demektir.

Sayısal bağlamlarda kullanılan dizeler

Bir dizenin sayı olarak değerlendirilmesi gerektiğinde (örneğin, aritmetik işlemler, int tür bildirimi, vb.), Sonucu belirlemek için aşağıdaki adımlar atılır:

1. Dize sayısal ise, (PHP_INT_MAX tarafından tanımlandığı gibi) int türü sınırlarına uyuyorsa ve dize bir tamsayı sayısal dizeyse, int olarak çözümlenir, aksi takdirde bir float olarak çözümlenir.
2. Bağlam, öncü sayısal dizelere izin veriyorsa ve dize tek ise, (PHP_INT_MAX tarafından tanımlandığı gibi) int türü sınırlarına uyuyorsa ve dizenin baştaki bölümü bir tamsayı sayısal dizeyse, int olarak çözümlenir, aksi takdirde bir float olarak çözümlenir. Ek olarak E_WARNING seviyesinde bir hata ortaya çıkar.
3. Dize sayısal değilse, bir TypeError yavrulanır.

PHP 8.0.0 öncesindeki davranış

PHP 8.0.0 öncesinde, bir dize yalnızca, önünde beyaz boşluklar varsa sayısal, sonunda beyaz boşluklar varsa öncü sayısal dize olduğu kabul edilirdi.

PHP 8.0.0 öncesinde, bir dize sayısal bir bağlamda kullanıldığında, yukarıdaki adımlar aşağıdaki farklılıklarla uygulanırdı:

• Öncü sayısal dize kullanımı E_WARNING yerine E_NOTICE seviyesinde bir hataya sebep olurdu.
• Dize sayısal değilse, E_WARNING seviyesinde bir hata ortaya çıkar ve değer olarak 0 dönerdi.

Sözdizimi

array(
    anahtar  => değer,
    anahtar2 => değer2,
    anahtar3 => değer3,
    ...
)

array(1) {
  [1]=>
  string(1) "d"
}

array(4) {
  ["foo"]=>
  string(3) "bar"
  ["bar"]=>
  string(3) "foo"
  [100]=>
  int(-100)
  [-100]=>
  int(100)
}

array(4) {
  [0]=>
  string(3) "foo"
  [1]=>
  string(3) "bar"
  [2]=>
  string(5) "hello"
  [3]=>
  string(5) "world"
}

array(4) {
  [0]=>
  string(1) "a"
  [1]=>
  string(1) "b"
  [6]=>
  string(1) "c"
  [7]=>
  string(1) "d"
}

array(7) {
  [1]=>
  string(1) "g"
  [-1]=>
  string(1) "d"
  ["01"]=>
  string(1) "e"
  ["1.5"]=>
  string(1) "f"
  [0]=>
  string(1) "h"
  [""]=>
  string(1) "j"
  [2]=>
  string(1) "l"
}

string(3) "bar"
int(24)
string(3) "foo"

$dizi[anahtar] = değer;
$dizi[] = değer;

// anahtar sadece int veya string türünde olabilir.
// değer herhangi bir türde olabilir.

Kullanışlı işlevler

Dizilerle çalışmak için kullanılabilecek işlevlerin tamamını Dizi İşlevleri bölümünde bulabilirsiniz.

Bilginize:

unset() işlevi bir diziden anahtar silmeyi mümkün kılar. Ama bu silme işlemi dizinin yeniden indislenmesiyle sonuçlanmaz. Eğer silme işleminin gerçekten "sil ve kaydır" yapmasını istiyorsanız, anahtarı sildikten sonra array_values() işlevini kullanarak diziyi yeniden indislemelisiniz.

<?php
$a = array(1 => 'bir', 2 => 'iki', 3 => 'üç');
unset($a[2]);
/* Bu silme işlemi dizi şöyle tanımlanmış gibi sonuçlanacaktır:
$a = array(1 => 'bir', 3 => 'üç');
böyle DEĞİL:
$a = array(1 => 'bir', 2 =>'üç');
*/

$b = array_values($a);
// $b artık array(0 => 'bir', 1 =>'üç') olmuştur
?>

foreach denetim yapısı özellikle diziler için tasarlanmıştır. Diziler üzerinde hareket edilmesini kolaylaştırır.

Diziler ne yapar, ne yapmaz?