xattr-文件系统扩展属性

	简介:
		xattr扩展,允许操作 '文件系统的扩展属性'
	安装:
		1.为了使用xattr,需要安装 'libattr'。
		2.切记:
			xattr扩展函数,仅仅作用于支持 '扩展属性的文件系统',并在挂载文件系统时,需要开启xattr。支持扩展属性常见的文件系统有:ext2, ext3, reiserfs, jfs和xfs。
		3.手册上有人注释:
			他在ext4文件系统使用 'xattr',一直不工作,最终发现是未启用 'xattr扩展属性',下面是它的解决方案:
			linux下的分区等,使用 'df' 可查看(好久没看过命令了...):
			/dev/sdb2 		/home 		ext4 		relatime,user_xattr(挂载文件系统就得启用!) 	0 		2
		4.安装PECL扩展:http://pecl.php.net/package/xattr
	预定义常量:
		XATTR_ROOT - 在root(信任)命名空间设置属性,需要root权限
		XATTR_DONTFOLLOW - 不要链接到符号链接指向到文件,就操作符号链接文件自身
		XATTR_CREATE - 如果扩展属性已经存在,函数返回false(创建新属性)
		XATTR_REPLACE - 如果扩展属性不存在,函数返回false(替换旧属性)
	函数:
		xattr_supported(string $filename[, int $flags = 0])
			检查给定文件所在的文件系统,是否支持 '扩展属性'。需要文件的 '读权限'。
			参数:
				$filename - 测试的文件路径
				$flags - 只支持 'XATTR_DONTFOLLOW' (看前面常量定义)
			返回值:
				true - 支持
				false - 不支持
				NULL - 不能决定(例如:错误的文件路径或缺少读权限)
		xattr_list(string $filename[, int $flags = 0])
			1.返回指定文件的扩展属性名称的列表
			2.扩展的属性有两种 不同的命名空间:user 和 root。user 命名空间对所有用户均有效,而 root 命名空间仅对拥有 root 权限的用户有效。 xattr 默认在 user 命名空间上操作,但可使用 flags 参数进行更改。
			参数:
				$filename - 测试的文件路径
				$flags - 支持 
							'XATTR_DONTFOLLOW' (看前面常量定义)
							'XATTR_ROOT' (看前面常量定义)
			示例:
				<?php
					$file = 'some_file';
					$root_attributes = xattr_list($file, XATTR_ROOT);	// root用户属性
					$user_attributes = xattr_list($file);				// 所有用户属性

					echo "Root attributes: \n";
					foreach ($root_attributes as $attr_name) {
					    printf("%s\n", $attr_name);
					}

					echo "\n User attributes: \n";
					foreach ($attributes as $attr_name) {
					    printf("%s\n", $attr_name);
					}
				?>
		xattr_set(string $filename, string $name, string $value[, int $flags = 0])
			1.给指定的文件设置一个扩展属性
			2.扩展的属性有两种 不同的命名空间:user 和 root。user 命名空间对所有用户均有效,而 root 命名空间仅对拥有 root 权限的用户有效。 xattr 默认在 user 命名空间上操作,但可使用 flags 参数进行更改。
			参数:
				$filename - 给哪个文件设置扩展属性
				$name - 扩展属性名。不存在将创建,存在则替换。可通过 flags 来改变默认行为。
				$value - 属性名
				flags - 4个都支持
			示例:
				<?php
					$file = 'my_favourite_song.wav';

					// 我们可以给文件设定各种我们想设置的属性!
					xattr_set($file, 'Artist', 'Someone');
					xattr_set($file, 'My ranking', 'Good');
					xattr_set($file, 'Listen count', '34');
				?>
		xattr_get(string $filename, string $name[, int $flags = 0])
			1.获取指定文件设置的某个扩展属性名的值
			2.扩展的属性有两种 不同的命名空间:user 和 root。user 命名空间对所有用户均有效,而 root 命名空间仅对拥有 root 权限的用户有效。 xattr 默认在 user 命名空间上操作,但可使用 flags 参数进行更改。
			参数:
				$filename - 给哪个文件设置扩展属性
				$name - 扩展属性名
				flags - 支持
							'XATTR_DONTFOLLOW' (看前面常量定义)
							'XATTR_ROOT' (看前面常量定义)
			示例:
				<?php
					$file = 'my_favourite_song.wav';

					// 获取属性
					xattr_get($file, 'Artist', XATTR_ROOT);
				?>
		xattr_remove(string $filename, string $name[, int $flags = 0])
			1.删除指定文件的扩展属性
			2.扩展的属性有两种 不同的命名空间:user 和 root。user 命名空间对所有用户均有效,而 root 命名空间仅对拥有 root 权限的用户有效。 xattr 默认在 user 命名空间上操作,但可使用 flags 参数进行更改。
			参数:
				$filename - 给哪个文件设置扩展属性
				$name - 扩展属性名
				flags - 支持
							'XATTR_DONTFOLLOW' (看前面常量定义)
							'XATTR_ROOT' (看前面常量定义)
			示例:
			<?php
				$file = 'some_file';
				$attributes = xattr_list($file);

				// 依次删除文件的所有扩展属性
				foreach ($attributes as $attr_name) {
				    xattr_remove($file, $attr_name);
				}
			?>

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值