xattr_set
(PECL xattr >= 0.9.0)
xattr_set — Bir ek özniteliği tanımlar
Açıklama
$dosya
, string $isim
, string $değer
[, int $seçenekler = 0
] )Belirtilen 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.
Değiştirgeler
-
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çeneklerdeğiştirgesi ile değiştirebilirsiniz. -
değer -
Özniteliğin değeri.
-
seçenekler -
Desteklenen xattr seçenekleri XATTR_CREATEEk ö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_DONTFOLLOWSembolik bağlar izlenmez, sembolik bağın kendisinde işlem yapar. XATTR_ROOTÖzniteliği root isim alanında tanımlar; root yetkisi gerektirir.
Dönen Değerler
Başarı durumunda TRUE, başarısızlık durumunda FALSE döner.
Örnekler
Ö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'));
?>
Ayrıca Bakınız
- xattr_get() - Bir özniteliğin değerini döndürür
- xattr_remove() - Bir ek özniteliği siler
