README

Contao是一款开源PHP内容管理系统，适用于那些想要一个易于维护的专业网站的群体。访问项目网站获取更多信息。

Contao被设计为一个Symfony包，可以用于为任何Symfony应用添加CMS功能。如果您还没有现有的Symfony应用，我们建议使用Contao管理版作为您应用的基础。

先决条件

Contao核心包在symfony/recipes-contrib仓库中有一个配方。确保通过运行以下命令为您的项目启用contrib配方，或者遵循安装过程中的说明来使用contrib配方。

composer config extra.symfony.allow-contrib true

将contao-component-dir添加到您的composer.json文件的extra部分。

composer config extra.contao-component-dir assets

安装

通过执行以下命令安装Contao及其所有依赖项：

composer require \
    contao/core-bundle:4.8.* \
    php-http/guzzle6-adapter:^1.1

请注意，您可以将php-http/guzzle6-adapter包与任何其他HTTP客户端实现交换。如果您已经有一个HTTP客户端实现，可以完全省略该包。

配置

在您的环境中配置DATABASE_URL，可以使用环境变量或使用Dotenv组件。

在config/packages/framework.yaml文件中启用ESI。

framework:
    esi: true

将Contao路由添加到您的config/routing.yaml文件中，并确保在最后加载ContaoCoreBundle，这样通配符路由就不会捕获您的应用路由。

ContaoCoreBundle:
    resource: "@ContaoCoreBundle/config/routes.yaml"

编辑您的config/security.yaml文件并合并所有providers、encoders、firewalls和access_control部分

security:
    password_hashers:
        Contao\User: auto
        Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface: auto

    providers:
        contao.security.backend_user_provider:
            id: contao.security.backend_user_provider

        contao.security.frontend_user_provider:
            id: contao.security.frontend_user_provider

    firewalls:
        contao_backend:
            request_matcher: contao.routing.backend_matcher
            provider: contao.security.backend_user_provider
            user_checker: contao.security.user_checker
            switch_user: true
            login_throttling: ~

            login_link:
                check_route: contao_backend_login_link
                signature_properties: [username, lastLogin]
                success_handler: contao.security.authentication_success_handler

            contao_login:
                remember_me: false

            logout:
                path: contao_backend_logout

        contao_frontend:
            request_matcher: contao.routing.frontend_matcher
            provider: contao.security.frontend_user_provider
            user_checker: contao.security.user_checker
            access_denied_handler: contao.security.access_denied_handler
            switch_user: false
            login_throttling: ~

            contao_login:
                remember_me: true

            remember_me:
                secret: '%kernel.secret%'
                remember_me_parameter: autologin
                token_provider:
                    doctrine: true

            logout:
                path: contao_frontend_logout

    access_control:
        - { path: ^%contao.backend.route_prefix%/login$, roles: PUBLIC_ACCESS }
        - { path: ^%contao.backend.route_prefix%/logout$, roles: PUBLIC_ACCESS }
        - { path: ^%contao.backend.route_prefix%(/|$), roles: ROLE_USER }
        - { path: ^/, roles: [PUBLIC_ACCESS] }

Contao核心包现在已安装并激活。使用contao:migrate命令升级数据库，并使用contao:user:create命令创建您的第一个后台用户。

许可协议

Contao根据LGPLv3许可协议许可。

获取支持

访问支持页面了解可用的支持选项。