PHP code example of gzqsts / file-path
1. Go to this page and download the library: Download gzqsts/file-path library . Choose the download type require .
2. Extract the ZIP file and open the index.php.
3. Add this code to the index.php.
<?php
require_once('vendor/autoload.php');
/* Start to develop here. Best regards https://php-download.com/ */
gzqsts / file-path example snippets
use Gzqsts\FilePath\Path;
// 创建路径对象
$path = new Path('uploads/images/2024/photo.jpg');
// 获取文件信息
echo $path->getFilename(); // photo
echo $path->getExtension(); // jpg
echo $path->getBasename(); // photo.jpg
echo $path->getPath(); // uploads/images/2024
// 转换为字符串
echo (string)$path; // uploads/images/2024/photo.jpg
use Gzqsts\FilePath\Path;
// 从文件路径创建
$path = new Path('uploads/images/photo.jpg');
// 从URL创建
$path = new Path('https://example.com/files/document.pdf');
// 从相对路径创建
$path = new Path('../images/logo.png');
$path = new Path('uploads/images/2024/photo.jpg');
// 获取文件名(不含扩展名)
$filename = $path->getFilename(); // photo
// 获取文件扩展名
$extension = $path->getExtension(); // jpg
// 获取完整文件名(含扩展名)
$basename = $path->getBasename(); // photo.jpg
// 获取目录路径
$dirPath = $path->getPath(); // uploads/images/2024
// 获取协议(URL)
$scheme = $path->getScheme(); // https 或 ''
// 获取主机(URL)
$host = $path->getHost(); // example.com 或 ''
// 获取端口(URL)
$port = $path->getPort(); // 80 或 ''
// 获取查询参数(URL)
$query = $path->getQuery(); // key=value 或 ''
$path = new Path('uploads/images/photo.jpg');
// 修改文件名
$newPath = $path->withFilename('newphoto');
// 结果: uploads/images/newphoto.jpg
// 修改扩展名
$newPath = $path->withExtension('png');
// 结果: uploads/images/photo.png
// 修改完整文件名
$newPath = $path->withBasename('newfile.png');
// 结果: uploads/images/newfile.png
// 追加目录
$newPath = $path->withPath('2024/11');
// 结果: uploads/images/2024/11/photo.jpg
// 替换整个路径
$newPath = $path->withPathAll('files/documents');
// 结果: files/documents/photo.jpg
// 修改协议
$newPath = $path->withScheme('https');
// 结果: https://uploads/images/photo.jpg
// 修改主机
$newPath = $path->withHost('example.com');
// 结果: //example.com/uploads/images/photo.jpg
// 修改端口
$newPath = $path->withPort('8080');
// 结果: //:8080/uploads/images/photo.jpg
// 添加查询参数
$newPath = $path->withQuery('token=abc123');
// 结果: uploads/images/photo.jpg?token=abc123
$path = new Path('uploads/images/photo.jpg');
// 使用正斜杠
$unixPath = $path->withDirSeparator('/');
// 结果: uploads/images/photo.jpg
// 使用反斜杠(Windows风格)
$windowsPath = $path->withDirSeparator('\\');
// 结果: uploads\images\photo.jpg
$path = new Path('uploads/images/photo.jpg');
// 转换为字符串(默认)
echo (string)$path; // uploads/images/photo.jpg
// 转换为字符串(带前缀路径)
echo $path->toString('storage'); // storage/uploads/images/photo.jpg
// 获取完整路径(包含协议、主机等)
echo $path->getFull(); // uploads/images/photo.jpg
// 静态方法:创建目录
Path::createDirs('/path/to/file.txt');
// 会自动创建 /path/to 目录(如果不存在)
$path = new Path('uploads/photo.jpg');
$newPath = $path
->withPath('2024/11')
->withFilename('newphoto')
->withExtension('png')
->withDirSeparator('/');
// 结果: 2024/11/newphoto.png
use Gzqsts\FilePath\Path;
// 示例1: 处理上传文件路径
$originalPath = 'temp/uploads/user123/photo.jpg';
$path = new Path($originalPath);
// 创建新的存储路径
$storagePath = $path
->withPathAll('storage/images')
->withPath(date('Y/m'))
->withFilename(uniqid())
->withExtension('jpg');
echo $storagePath->toString();
// 输出: storage/images/2024/11/507f1f77bcf86cd799439011.jpg
// 示例2: 处理URL路径
$url = 'https://example.com/files/document.pdf?download=1';
$path = new Path($url);
echo $path->getScheme(); // https
echo $path->getHost(); // example.com
echo $path->getBasename(); // document.pdf
echo $path->getQuery(); // download=1
// 修改URL
$newUrl = $path
->withHost('cdn.example.com')
->withPath('cdn/files')
->getFull();
echo $newUrl;
// 输出: https://cdn.example.com/cdn/files/document.pdf?download=1
// 示例3: 路径规范化
$path = new Path('uploads\\images//photo.jpg');
echo (string)$path;
// 输出: uploads/images/photo.jpg(自动规范化)
// 示例4: 创建目录
$filePath = '/var/www/uploads/2024/11/file.txt';
Path::createDirs($filePath);
// 自动创建 /var/www/uploads/2024/11 目录
public function __construct(string $uri)