README

PHP 中处理路径的实用工具。

• 安装
• 用法
  • 清理
  • 连接
  • 绝对路径
  • 标准化
  • 是否为绝对路径
  • 是否为根目录
• 静态访问
• 变更日志
• 测试
• 贡献
• 安全
• 致谢
• 许可证

安装

您可以使用 composer 安装此软件包。

$ composer require bhittani/path --prefer-dist

用法

此软件包提供了一些处理路径时的有用实用工具。

<?php

require_once __DIR__ . '/vendor/autoload.php';

$path = new \Bhittani\Path\Path();

// Use the API calls as demonstrated below.

清理

将反斜杠转换为正斜杠。

echo $path->sanitize('\foo/bar\baz'); // '/foo/bar/baz'

连接

连接部分路径。

echo $path->join('foo', './bar', '../baz/..'); // 'foo'

这也会在底层清理路径。

绝对路径

将路径转换为绝对路径。

echo $path->absolute('/foo'); // '/foo'
echo $path->absolute('foo'); // getcwd().'/foo'
echo $path->absolute('/foo', true); // getcwd().'/foo'

第二个 (布尔) 参数将强制将路径附加到 getcwd()。

标准化

标准化与 join 相同，但它确保了绝对路径。

echo $path->normalize('/foo', 'bar/', '../baz/'); // '/foo/baz'
echo $path->normalize('foo', './bar', '/../baz'); // getcwd().'/foo/baz'

是否为绝对路径

确定路径是否为绝对路径。

echo $path->isAbsolute('/foo/bar'); // true
echo $path->isAbsolute('foo/bar'); // false

是否为根目录

确定路径是否为根目录。

echo $path->isRoot('/'); // true
echo $path->isRoot('c:/'); // true
echo $path->isRoot('http://'); // true
echo $path->isRoot('http://example.com'); // true
echo $path->isRoot('/foo'); // false

任何根路径也都是绝对路径。因此，当 isRoot 为真时，isAbsolute 总是为真。

静态访问

有一个 StaticPath 类可用。

<?php

require_once __DIR__ . '/vendor/autoload.php';

use Bhittani\Path\StaticPath;

echo StaticPath::normalize('/foo/', '/bar/'); // '/foo/bar'

可以通过静态访问调用任何公共方法。

变更日志

有关更改的更多信息，请参阅 CHANGELOG。

测试

git clone https://github.com/kamalkhan/path

cd path

composer install

composer test

贡献

有关详细信息，请参阅 CONTRIBUTING 和 CONDUCT。

安全

如果您发现任何安全相关的问题，请通过电子邮件 shout@bhittani.com 而不是使用问题跟踪器。

致谢

• Kamal Khan
• 所有贡献者

许可证

MIT 许可证 (MIT)。有关更多信息，请参阅 许可证文件。