README

#mymodule

mymodule 是一个用于处理 Anax-MVC 框架中图像上传的类（参见 https://github.com/mosbth/Anax-MVC）

#许可证

此软件是免费软件，带有 MIT 许可证。

#描述和测试指南

mymodule 包含可以用于在 Anax-MVC 框架中处理上传图像的 php 类 UploadController。未来的版本还将允许使用简单的代理脚本来从根级别或更高级别的安全文件夹中下载。在这个第一个版本中，不支持下载，上传的文件存储在默认文件夹 Anax-MVC/webroot/img（您需要创建一个名为 "upload" 的新可写文件夹）。

上传的文件将通过 try 和 catch 方法传递，该方法会检查错误、无效参数、上传表单中定义的文件大小（MAX_FILE_SIZE）以及脚本本身中定义的文件大小。文件名长度限制为 100 个字符，只允许 JPG、PNG 和 GIF 图像。如果文件通过 "move_uploaded_file()" 执行的 "有效上传文件" 检查，则使用 php 函数 sha1_file() 获得的安全文件名存储在磁盘上。

如果上传的文件未能通过这些检查中的任何一个，它将由 Anax-MVC 异常处理程序处理，并显示错误消息。

为了测试此包，您首先需要从 Github 下载框架 'Anax-MVC'。在这个描述中，我将假设您在计算机上使用 GIT bash。我还会假设您已安装 Composer 并可以在命令行上使用 Composer。

启动 GIT Bash 并更改目录，以便您的命令行提示符出现在您想要用于此下载的工作目录中。在 "$" 提示符后，您可能想要输入以下行

git clone https://github.com/mosbth/Anax-MVC.git

下载完成后，您可能想要打开您的文本编辑器（例如 JEdit 或其他）并打开 Anax-MVC 文件夹中的 composer.json 文件。将以下行添加到该文件的末尾，就在最后的括号之前

      "require": {

    "tommy001/mymodule": "dev-master"
}

现在使用您的命令行界面将目录更改为 Anax-MVC。在命令行上键入 "Composer validate" 以检查您的 composer.json 文件是否有效。如果检查通过，您可以在命令行上键入 "Composer install"。

这将下载包 Mymodule 到 Anax-MVC 的 "vendor" 文件夹中。

mymodule/webroot 文件夹中有一个名为 index.php 的文件。将此文件复制到 Anax-MVC/webroot 文件夹中。然后，将 mymodule/view 文件夹中的文件复制到 Anax-MVC/app/view/mymodule 新文件夹中。最后，将 mymodule/src 文件夹中的文件复制到 Anax-MVC/app/src/Mymodule 新文件夹中。如上所述，您还需要创建一个名为 Anax-MVC/webroot/img/upload 的可写文件夹。

为了简单测试上传类，mymodule/webroot 文件夹提供了一个基本的 Sqlite 数据库。将此文件移动到 Anax-MVC webroot 文件夹。

完成此设置后，您可以指向上面提到的 index.php，并上传一个有效的图像。

原始文件名的清理版本存储在数据库中，例如可以用于表示下载列表中的图像。您可能希望将特定语言字符及其替换项添加到类 UploadCOntroller 中第 180 行找到的模式中。

图像的相对磁盘路径以安全文件名存储在数据库中，例如 "img/upload/6beb8c7b6305b58cb834161d5a4a383b22101b58.jpg"。