(PECL xattr >= 0.9.0)
xattr_set — Bir ek özniteliği tanımlar
$dosya
, string $isim
, string $değer
[, int $seçenekler = 0
] ) : boolBelirtilen dosyanın belirtilen özniteliğini tanımlar.
Ek öznitelikler iki isim alanına sahiptir: kullanıcı ve root. Kullanıcı isim alanını tüm kullanıcılar kullanabilir; root isim alanını ise sadece root yetkilerine sahip kullanıcılar kullanabilir. xattr eklentisi öntanımlı olarak kullanıcı isim alanında işlem yapar, fakat bu davranış seçenekler değiştirgesi ile değiştirilebilir.
dosyaÖzniteliği tanımlanacak dosyanın yolu.
isim
Ek özniteliğin ismi. Öznitelik yoksa oluşturulur varsa değeri
değiştirilir. Bu davranışı seçenekler
değiştirgesi ile değiştirebilirsiniz.
değerÖzniteliğin değeri.
seçenekler
XATTR_CREATE |
Ek öznitelik zaten tanımlıysa işlev başarısız olur. |
XATTR_REPLACE |
Öznitelik evvelce tanımlanmamışsa işlev başarısız olur. |
XATTR_DONTFOLLOW |
Sembolik bağlar izlenmez, sembolik bağın kendisinde işlem yapar. |
XATTR_ROOT |
Özniteliği root isim alanında tanımlar; root yetkisi gerektirir. |
Başarı durumunda TRUE, başarısızlık durumunda FALSE döner.
Örnek 1 - Bir .wav dosyasında ek öznitelik tanımlamak
<?php
$file = 'sevilen_sarki.wav';
xattr_set($file, 'Sarkici', 'Birisi');
xattr_set($file, 'Kalite', 'Eh iste');
xattr_set($file, 'Dinleme sayisi', '34');
/* ... bazı kodlar ... */
printf("Bu şarkı %d kere çalınmış", xattr_get($file, 'Dinleme sayisi'));
?>