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)