README

ChillDevFileManagerBundle 是一个 Symfony2 bundle，它提供从您的 Web 应用程序中管理文件的功能。

安装

此包作为 Composer 包 提供。要安装它，只需将以下依赖定义添加到您的 composer.json 文件中

"chilldev/file-manager-bundle": "dev-master"

如果您想使用特定版本，请将 dev-master 替换为不同的约束条件。

如果您正在使用 Symfony2 的最新版本，请使用 dev-develop 版本而不是 dev-master。 (但此版本尚未经过适当测试)

注意：此包需要 PHP 5.4。

注意：您还需要安装 default 模板引擎，并确保所有必需的包也已在您的应用程序中加载。有关详细信息，请参阅 安装说明。

配置

为了使用此包，在您的内核中加载它

<?php

use ChillDev\Bundle\FileManagerBundle\ChillDevFileManagerBundle;

use Symfony\Component\HttpKernel\Kernel as BaseKernel;

class Kernel extends BaseKernel
{
    public function registerBundles()
    {
        $bundles = [
            new ChillDevFileManagerBundle(),
        ];
    }
}

包含包路由

ChillDevFileManagerBundle:
    resource: "@ChillDevFileManagerBundle/Controller/"
    type: "annotation"
    prefix: "/filemanager"

然后配置您的磁盘

chilldev_filemanager:
    disks:
        disk_id:
            label: "Your filesystem"
            source: "/var/www/"

有关详细信息，请参阅 配置选项。

使用

前端

通常，ChillDevFileManagerBundle 是面向最终用户的（或至少应该是）组件。然而，可能会有一些与前端展示相关的问题（主要是 JavaScript 相关的）。要获得此包 UI 最好的体验，请参阅 使用文档 中需要了解的事项列表。

动作处理程序

您可能感兴趣的另一个方面是实现自己的文件动作。您可以通过注册 HandlerInterface 接口的实例轻松扩展 ChillDevFileManagerBundle，以便允许额外的文件动作（甚至是特定文件类型的）。您可以通过将自定义动作处理程序绑定到特定的 MIME 类型来实现。

class MyHandler implements HandlerInterface
{
    public function getLabel()
    {
        return 'My action';
    }

    public function supports($mimeType)
    {
        return preg_match('#^image/#', $mimeType) > 0;
    }

    public function handle(Request $request, Disk $disk, $path)
    {
        // handle action request
    }
}

您可以在此处阅读更详细的信息：

额外功能

作为额外功能，您可以集成 ChillDevFileManagerBundle 与 SonataAdminBundle。您可以在 本节 中了解如何进行操作。

资源

• 源代码文档
• GitHub 页面上的 API 文档
• 问题跟踪器
• Packagist 包
• Chillout Development @ GitHub
• Chillout Development @ Facebook
• 在 Wrzasq.pl 上的帖子

贡献

你想帮助改进这个项目吗？只需 创建分支 并提交拉取请求。你可以自己完成所有事情，不需要询问是否可以，只管做你想要的所有酷炫事情！

本项目遵循 MIT 许可证 发布。

作者

ChillDevFileManagerBundle 由 Chillout Development 提供。

贡献者列表

• Rafał "Wrzasq" Wrzeszcz (wrzasq.pl).