ozguard PHP Eklentisi Kurulumu

Bu kılavuz kendi sunucunuz (VPS, dedicated veya şirket içi) içindir. Paylaşımlı hosting paketlerinde PHP eklentisi yüklenemediği için kod şifreleme çalışmaz; ayrıntılar için SSS sayfamıza bakın. SSS

UYUMLULUK MATRİSİ

Her PHP çeşidine ayrı derleme

Native eklentiler, birebir PHP küçük sürümüne ve thread-safety durumuna bağlanır. php -v çıktınızı bir satırla eşleştirin; yayınlanan her hücre, runtime sayfasında bir indirme demektir.

PHP sürümü	Windows · NTS	Windows · TS (ZTS)	Linux · NTS	Linux · TS (ZTS)
`PHP 8.0`	Mevcut	Mevcut	Yok	Yok
`PHP 8.1`	Mevcut	Mevcut	Mevcut	Mevcut
`PHP 8.2`	Mevcut	Mevcut	Mevcut	Mevcut
`PHP 8.3`	Mevcut	Mevcut	Mevcut	Mevcut
`PHP 8.4`	Mevcut	Mevcut	Mevcut	Mevcut
`PHP 8.5`	Mevcut	Mevcut	Mevcut	Mevcut

Windows: PHP 8.0–8.5 için NTS ve TS derlemeleri, x64. Linux: PHP 8.1–8.5 için NTS ve TS (ZTS) derlemeleri, x64 — dağıtım/FPM PHP'leri pratikte NTS, mod_php ve özel derlemeler TS ister. 32-bit PHP desteklenmez. Her hücre runtime matrisinde bir indirme ve SHA-256 sağlamasıdır.

İkili dosyalar nerede?

ozguard.dll / ozguard.so dosyaları, PHP çeşidine göre runtime matrisinden indirilir — her satır kendi SHA-256 sağlama toplamını taşır.

Derlemenizi alın

Beş dakikalık konsol

Platform başına tam komut dizileri — sekmeyi kopyalayın, yapıştırın, PHP'yi yeniden başlatın, bitti. Her işletim sistemi için rehberli anlatımlar aşağıda.

Linux · bash

sudo cp ozguard.so "$(php -i | awk -F'=> ' '/extension_dir/{print $2}')/"
echo "extension = ozguard.so" | sudo tee /etc/php/8.3/mods-available/ozguard.ini
sudo phpenmod ozguard && sudo systemctl restart php8.3-fpm

Windows · PowerShell

Copy-Item .\ozguard.dll "C:\AppServ\php8\ext\"
Add-Content "C:\AppServ\php8\php.ini" "`nextension = \"C:\AppServ\php8\ext\ozguard.dll\""
httpd -k restart   # Apache — veya: iisreset

php.ini

; php.ini — OnionZero çalışma zamanını etkinleştirin
extension = ozguard.so

; Satıcı açık anahtarı eklentiye gömülüdür — başka ayar gerekmez

Dockerfile

FROM php:8.3-fpm
COPY ozguard.so /usr/local/lib/php/extensions/
RUN echo "extension = ozguard.so" \
  > /usr/local/etc/php/conf.d/ozguard.ini

Windows üzerinde kurulum

Eklenti dosyasını kopyalayın
ozguard.dll dosyasını PHP uzantı dizininize kopyalayın; AppServ kurulumlarında bu genellikle C:\AppServ\php8\ext\ dizinidir.
php.ini satırlarını ekleyin
Kullandığınız php.ini dosyasını açın (php --ini komutu doğru dosyayı gösterir) ve şu satırları ekleyin:
php.ini
```
extension = "C:\AppServ\php8\ext\ozguard.dll"

; Satıcı açık anahtarı eklentiye gömülüdür — anahtar ayarı gerekmez.
```
Web sunucusunu yeniden başlatın
Apache için "httpd -k restart", IIS için "iisreset", PHP-FPM kullanıyorsanız ilgili Windows servisini yeniden başlatın. CLI (komut satırı) için yeniden başlatma gerekmez.
Kurulumu doğrulayın
Komut satırında şu komutu çalıştırın; çıktıda ozguard satırı görünmelidir:
komut satırı
```
php -m | findstr ozguard
```

phpinfo() çıktısında ozguard bölümü görünür; buradaki anahtar parmak izi, ürün paketinizle teslim edilen parmak iziyle aynı olmalıdır.

Linux üzerinde kurulum

Eklenti dosyasını kopyalayın
PHP uzantı dizinini öğrenin ve ozguard.so dosyasını oraya kopyalayın:
terminal
```
php -i | grep extension_dir
sudo cp ozguard.so /usr/lib/php/20230831/
```
php.ini satırlarını ekleyin
PHP-FPM'in kullandığı php.ini dosyasına şu satırları ekleyin:
php.ini
```
extension = ozguard.so

; Satıcı açık anahtarı eklentiye gömülüdür — anahtar ayarı gerekmez.
```
Alternatif: phpenmod ile etkinleştirin
Debian/Ubuntu tabanlı sistemlerde ayrı bir ini dosyası da kullanabilirsiniz:
terminal
```
echo 'extension = ozguard.so' | sudo tee /etc/php/8.3/mods-available/ozguard.ini
sudo phpenmod ozguard
```
PHP-FPM'i yeniden başlatın
Mod_php ile Apache kullanıyorsanız apache2 servisini yeniden başlatın.
terminal
```
sudo systemctl restart php8.3-fpm
```
Kurulumu doğrulayın
Aşağıdaki komut ozguard satırını göstermelidir:
terminal
```
php -m | grep ozguard
```

Doğrulama

Kurulumun başarılı olduğunu iki yolla teyit edebilirsiniz:

php -m çıktısında ozguard modülünün listelenmesi, eklentinin PHP tarafından yüklendiğini gösterir.
Bir phpinfo() sayfasındaki ozguard bölümünde görünen anahtar parmak izi, paketinizle gelen değerle eşleşmelidir — bu, eklenti ile şifreli dosyalarınızın birbirine ait olduğunu kanıtlar.

Sorun giderme

"Unable to load dynamic library" hatası

Eklenti dosyası PHP sürümünüzle veya thread-safety modunuzla eşleşmiyor demektir. php -v çıktınıza uyan hücreyi runtime matrisinden indirin (Windows 8.0–8.5 NTS/TS, Linux 8.1–8.5 NTS/TS, x64); 32-bit PHP desteklenmez.

php -m çıktısında ozguard yok

Doğru php.ini dosyasını düzenlediğinizden emin olun (php --ini komutu yolu gösterir) ve PHP-FPM / web sunucusunu yeniden başlattığınızı doğrulayın.

PHP yükseltmesinden sonra çalışmıyor

PHP eklentileri küçük sürüme özeldir (ör. 8.3 → 8.4). Yükseltmeden önce yeni sürüme derlenmiş eklenti dosyasını bizden talep edin.

Konteyner filoları: ozguard'ı imaja bir kez gömün; her konteyner kasa devrede olarak uyanır. Yukarıdaki konsolun Dockerfile sekmesi tarifin tamamıdır.

Kurulumda desteğe mi ihtiyacınız var?

Ekibimiz sunucu ortamınıza özel yönlendirme yapabilir; bize yazmanız yeterli.

Bize Ulaşın

ozguard eklentisini sunucunuza kurun