Kurulum

PHP'nin OpenSSL desteğini kullanmak için PHP'yi --with-openssl[=DiZiN] seçeneği ile derlemelisiniz.

OpenSSL kütüphanesi çalışma anındaki normal işlemler için ek gereksinimlere sahiptir. En önemlisi, OpenSSL'in, rasgele veya yarı rasgele bir sayı üretecine erişebilmesi gerekir; çoğu Unix ve Unix benzeri (Linux dahil) platform için bu /dev/urandom veya /dev/random aygıtına erişebilmek anlamına gelir.

Bilginize: Win32 kullanıcıları için

Bu eklentinin çalışabilmesi için bazı DLL dosyalarının bulunduğu yerlerin Windows sistem PATH'ında tanımlı olması gerekir. Bunun nasıl yapılacağı SSS altında "PHP dizinimi Windows'ta PATH'a nasıl eklerim" başlığı altında açıklanmıştır. Eklenti, DLL dosyaları PHP dizininden Windows system dizinine taşındığında da çalışırsa da (çünkü system dizini sistem PATH'ında zaten vardır) bu önerilmez. Bu eklentinin çalışabilmesi için bulunduğu dizine PATH üzerinden erişilebilinmesi gereken dosyanın ismi: libeay32.dll

Anahtar üretim ve sertifika imzalama işlevlerini kullanmayı düşünüyorsanız sisteminizde ek olarak geçerli bir openssl.cnf kurulu olmalıdır. Win32 çalıştırılabilir paketlerine örnek bir yapılandırma dosyası ekliyoruz. Bu dosya openssl dizinine konmaktadır.

PHP openssl.cnf dosyasını şu mantıksal sırayla araştırır:

  • OPENSSL_CONF ortam değişkeni varsa, değişkenin değeri yapılandırma dosyasının yolu olarak (dosya ismi dahil) kullanılır.
  • SSLEAY_CONF ortam değişkeni varsa, değişkenin değeri yapılandırma dosyasının yolu olarak (dosya ismi dahil) kullanılır.
  • openssl.cnf dosyasının öntanımlı sertifika alanında bulunduğu varsayılır (openssl DLL'i derlenirken böyle yapılandırılır). Yani, dosyanın öntanımlı yeri: c:\usr\local\ssl\openssl.cnf.

Kurulum sırasında yapılandırma dosyasının aranacağı yerin c:\usr\local\ssl\openssl.cnf mi olacağına yoksa ortam değişkenlerini kullanarak başka bir yer mi belirtileceğine karar vermelisiniz. Bir yapılandırma dosyası gerektiren işlevlerdeki ayarlar değiştirgesini kullanarak dosyanın öntanımlı yerini geçersiz kılabilirsiniz.