FileNamingResolver 项目常见问题解决方案

FileNamingResolver 项目常见问题解决方案

FileNamingResolver :open_file_folder: A lightweight library which helps to resolve a file/directory naming of uploaded files using various naming strategies. 项目地址: https://gitcode.com/gh_mirrors/fi/FileNamingResolver

1. 项目基础介绍与主要编程语言

FileNamingResolver 是一个轻量级的PHP库，旨在帮助解决上传文件或目录的命名问题，支持使用多种命名策略。该项目的目标是仅处理命名问题，而不直接操作文件或目录。如果需要文件系统抽象层，可以考虑使用 Gaufrette、symfony/filesystem 或 Flysystem 等库。该项目的主要编程语言是 PHP。

2. 新手常见问题与解决方案

问题一：如何安装 FileNamingResolver

问题描述： 新手在使用该项目时不知道如何正确安装。

解决步骤：

1. 使用 Composer 进行安装，这是推荐的方式。在命令行中执行以下命令：

   $ composer require bocharsky-bw/file-naming-resolver
   

2. 如果不使用 Composer，需要手动注册该包到自动加载器中，遵循 PSR-4 自动加载标准，或者直接下载库文件并在脚本中引入必要的文件：

   require_once __DIR__ . '/path/to/library/src/FileNamingResolver.php';
   

问题二：如何使用不同的命名策略

问题描述： 新手不清楚如何选择和使用不同的命名策略。

解决步骤：

1. 确定要使用的命名策略。FileNamingResolver 提供了多种策略，如 HashNamingStrategy、DatetimeNamingStrategy 等。
2. 创建相应的命名策略对象。例如，使用哈希策略：

   use FileNamingResolver\NamingStrategy\HashNamingStrategy;
   
   $hashStrategy = new HashNamingStrategy();
   

3. 创建文件命名解析器，并将策略对象传递给它：

   use FileNamingResolver\FileNamingResolver;
   
   $resolver = new FileNamingResolver($hashStrategy);
   

问题三：如何处理文件上传后的命名

问题描述： 新手不知道如何使用 FileNamingResolver 对上传的文件进行命名。

解决步骤：

1. 上传文件后，创建一个 FileInfo 对象，从上传文件的完整路径（FQFN）开始：

   use FileNamingResolver\FileInfo;
   
   $srcFileInfo = new FileInfo(__DIR__ . '/uploads/image.jpg');
   

2. 使用之前创建的命名策略对象或文件命名解析器对文件进行重命名：

   $newName = $resolver->resolve($srcFileInfo);
   

3. 使用新的文件名进行后续的文件操作，如保存、移动等。

FileNamingResolver :open_file_folder: A lightweight library which helps to resolve a file/directory naming of uploaded files using various naming strategies. 项目地址: https://gitcode.com/gh_mirrors/fi/FileNamingResolver