PHPackages                             jmather/symfony-sonata-distribution - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. jmather/symfony-sonata-distribution

ActiveLibrary[Framework](/categories/framework)

jmather/symfony-sonata-distribution
===================================

The "Symfony Sonata Edition" distribution

0.0.1(11y ago)5144719[6 PRs](https://github.com/jmather/symfony-sonata-distribution/pulls)PHPPHP &gt;=5.3.3

Since Mar 3Pushed 2y ago7 watchersCompare

[ Source](https://github.com/jmather/symfony-sonata-distribution)[ Packagist](https://packagist.org/packages/jmather/symfony-sonata-distribution)[ RSS](/packages/jmather-symfony-sonata-distribution/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (44)Versions (12)Used By (0)

Symfony Sonata Distribution
===========================

[](#symfony-sonata-distribution)

Welcome to the Symfony Sonata Distribution - a fully-functional Symfony2 Sonata application that you can use as the skeleton for your new application.

This distribution exists to save you from repeating all the steps needed to create a basic Sonata app.

This document contains information on how to download, install, and start using Symfony with Sonata. For a more detailed explanation, see the [Installation](http://symfony.com/doc/2.4/book/installation.html)chapter of the Symfony Documentation.

NOTE: For older Symfony versions use the corresponding branch.

1. Installing the Sonata Distribution

---

When it comes to installing the Symfony Sonata Distribution, you have the following options.

### Use Composer (*recommended*)

[](#use-composer-recommended)

As Symfony uses [Composer](http://getcomposer.org/) to manage its dependencies, the recommended way to create a new project is to use it.

If you don't have Composer yet, download it following the instructions on  or just run the following command:

```
curl -s http://getcomposer.org/installer | php

```

Then, use the `create-project` command to generate a new Symfony Sonata application:

```
php composer.phar create-project -s dev jmather/symfony-sonata-distribution path/to/install

```

Composer will install Symfony and all its dependencies under the `path/to/install` directory.

### Download an Archive File

[](#download-an-archive-file)

To quickly test Symfony Sonata, you can also download an [archive](https://github.com/jmather/symfony-sonata-distribution/archive/master.zip) of the Sonata Distribution and unpack it somewhere under your web server root directory.

You also need to install all the necessary dependencies. Download composer (see above) and run the following command:

```
php composer.phar install

```

2. Checking your System Configuration

---

Before starting coding, make sure that your local system is properly configured for Symfony.

Execute the `check.php` script from the command line:

```
php app/check.php

```

Access the `config.php` script from a browser:

```
http://localhost/path/to/symfony/app/web/config.php

```

If you get any warnings or recommendations, fix them before moving on.

3. Set up, initialize and browse the app

---

### Initializing the DB

[](#initializing-the-db)

Before you can run the server and log in to Sonata you need to create the tables first.

```
./app/console doctrine:schema:create

```

### Create the users

[](#create-the-users)

You can either create a handful of users like this (one of the usernames is 'superadmin' with password 'test')

```
./app/console doctrine:fixtures:load

```

Or you can manually create a user yourself

```
./app/console fos:user:create username emai@example.com password
./app/console fos:user:promote username ROLE_SONATA_ADMIN

```

### Install assets:

[](#install-assets)

```
./app/console assets:install --symlink --relative web

```

### Start the server:

[](#start-the-server)

Congratulations! You're now ready to use Symfony Sonata

```
./app/console server:run

```

### Login

[](#login)

Now you can login as user 'superadmin' with password 'test' at

```
http://localhost:8000/admin

```

Warning
-------

[](#warning)

Currently .htaccess is configured to use app\_dev.php but not app.php (production - no debug). When you launch your application don't forget to use app.php.

Browsing the Demo Application
-----------------------------

[](#browsing-the-demo-application)

From the `config.php` page, click the "Bypass configuration and go to the Welcome page" link to load up your first Symfony page.

You can also use a web-based configurator by clicking on the "Configure your Symfony Application online" link of the `config.php` page.

To see a real-live Symfony page in action, access the following page:

```
web/app_dev.php/demo/hello/Fabien

```

4. Getting started with Symfony

---

This distribution is meant to be the starting point for your Symfony applications, but it also contains some sample code that you can learn from and play with.

A great way to start learning Symfony is via the [Quick Tour](http://symfony.com/doc/2.4/quick_tour/the_big_picture.html), which will take you through all the basic features of Symfony2.

Once you're feeling good, you can move onto reading the official [Symfony2 book](http://symfony.com/doc/2.4/index.html).

A default bundle, `AcmeDemoBundle`, shows you Symfony2 in action. After playing with it, you can remove it by following these steps:

- delete the `src/Acme` directory;
- remove the routing entries referencing AcmeBundle in `app/config/routing_dev.yml`;
- remove the AcmeBundle from the registered bundles in `app/AppKernel.php`;
- remove the `web/bundles/acmedemo` directory;
- remove the `security.providers`, `security.firewalls.login` and `security.firewalls.secured_area` entries in the `security.yml` file or tweak the security configuration to fit your needs.

What's inside Symfony Sonata Distribution?
------------------------------------------

[](#whats-inside-symfony-sonata-distribution)

The Symfony Sonata Distribution is based on the Symfony Standard Edition. Additionally the following bundles are used to configure a fully functional Sonata application:

- [**SonataCoreBundle**](http://sonata-project.org/bundles/core/master/doc/index.html) - The foundation on which the Sonata bundles rest
- [**SonataAdminBundle**](http://sonata-project.org/bundles/admin/2-2/doc/index.html) - The main bundle needed to create the admin interface
- [**SonataDoctrineORMAdminBundle**](http://sonata-project.org/bundles/doctrine-orm-admin/2-2/doc/index.html) - Integrates Doctrine ORM project with the admin bundle
- [**FOSUserBundle**](https://github.com/FriendsOfSymfony/FOSUserBundle) - Provides user management
- [**SonataUserBundle**](http://sonata-project.org/bundles/user/master/doc/reference/installation.html) - Integrates the FOSUserBundle and adds some features
- [**SonataBlockBundle**](http://sonata-project.org/bundles/block/master/doc/index.html) - This bundle provides a block management solution

There are some more bundles necessary to run the application so take a look at the composer.json file.

What's inside Symfony Standard Edition
--------------------------------------

[](#whats-inside-symfony-standard-edition)

The Symfony Standard Edition is configured with the following defaults:

- Twig is the only configured template engine;
- Doctrine ORM/DBAL is configured;
- Swiftmailer is configured;
- Annotations for everything are enabled.

It comes pre-configured with the following bundles:

- **FrameworkBundle** - The core Symfony framework bundle
- [**SensioFrameworkExtraBundle**](http://symfony.com/doc/2.4/bundles/SensioFrameworkExtraBundle/index.html) - Adds several enhancements, including template and routing annotation capability
- [**DoctrineBundle**](http://symfony.com/doc/2.4/book/doctrine.html) - Adds support for the Doctrine ORM
- [**TwigBundle**](http://symfony.com/doc/2.4/book/templating.html) - Adds support for the Twig templating engine
- [**SecurityBundle**](http://symfony.com/doc/2.4/book/security.html) - Adds security by integrating Symfony's security component
- [**SwiftmailerBundle**](http://symfony.com/doc/2.4/cookbook/email.html) - Adds support for Swiftmailer, a library for sending emails
- [**MonologBundle**](http://symfony.com/doc/2.4/cookbook/logging/monolog.html) - Adds support for Monolog, a logging library
- [**AsseticBundle**](http://symfony.com/doc/2.4/cookbook/assetic/asset_management.html) - Adds support for Assetic, an asset processing library
- [**JMSSecurityExtraBundle**](http://jmsyst.com/bundles/JMSSecurityExtraBundle/master) - Allows security to be added via annotations
- [**JMSDiExtraBundle**](http://jmsyst.com/bundles/JMSDiExtraBundle/master) - Adds more powerful dependency injection features
- **WebProfilerBundle** (in dev/test env) - Adds profiling functionality and the web debug toolbar
- **SensioDistributionBundle** (in dev/test env) - Adds functionality for configuring and working with Symfony distributions
- [**SensioGeneratorBundle**](http://symfony.com/doc/2.4/bundles/SensioGeneratorBundle/index.html) (in dev/test env) - Adds code generation capabilities
- **AcmeDemoBundle** (in dev/test env) - A demo bundle with some example code

Enjoy!

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community27

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 67.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~114 days

Total

5

Last Release

4359d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/450978?v=4)[Jacob Mather](/maintainers/jmather)[@jmather](https://github.com/jmather)

---

Top Contributors

[![fabpot](https://avatars.githubusercontent.com/u/47313?v=4)](https://github.com/fabpot "fabpot (447 commits)")[![Seldaek](https://avatars.githubusercontent.com/u/183678?v=4)](https://github.com/Seldaek "Seldaek (32 commits)")[![jmather](https://avatars.githubusercontent.com/u/450978?v=4)](https://github.com/jmather "jmather (29 commits)")[![brikou](https://avatars.githubusercontent.com/u/383212?v=4)](https://github.com/brikou "brikou (17 commits)")[![Tobion](https://avatars.githubusercontent.com/u/610090?v=4)](https://github.com/Tobion "Tobion (14 commits)")[![stealth35](https://avatars.githubusercontent.com/u/196110?v=4)](https://github.com/stealth35 "stealth35 (14 commits)")[![stof](https://avatars.githubusercontent.com/u/439401?v=4)](https://github.com/stof "stof (12 commits)")[![eikes](https://avatars.githubusercontent.com/u/219275?v=4)](https://github.com/eikes "eikes (9 commits)")[![kriswallsmith](https://avatars.githubusercontent.com/u/33886?v=4)](https://github.com/kriswallsmith "kriswallsmith (9 commits)")[![schmittjoh](https://avatars.githubusercontent.com/u/197017?v=4)](https://github.com/schmittjoh "schmittjoh (8 commits)")[![weaverryan](https://avatars.githubusercontent.com/u/121003?v=4)](https://github.com/weaverryan "weaverryan (7 commits)")[![vicb](https://avatars.githubusercontent.com/u/248818?v=4)](https://github.com/vicb "vicb (6 commits)")[![havvg](https://avatars.githubusercontent.com/u/126898?v=4)](https://github.com/havvg "havvg (5 commits)")[![jmfontaine](https://avatars.githubusercontent.com/u/174728?v=4)](https://github.com/jmfontaine "jmfontaine (4 commits)")[![jalliot](https://avatars.githubusercontent.com/u/387904?v=4)](https://github.com/jalliot "jalliot (4 commits)")[![arjona](https://avatars.githubusercontent.com/u/139953?v=4)](https://github.com/arjona "arjona (4 commits)")[![lsmith77](https://avatars.githubusercontent.com/u/300279?v=4)](https://github.com/lsmith77 "lsmith77 (4 commits)")[![gajdaw](https://avatars.githubusercontent.com/u/676675?v=4)](https://github.com/gajdaw "gajdaw (4 commits)")[![ajessu](https://avatars.githubusercontent.com/u/334919?v=4)](https://github.com/ajessu "ajessu (3 commits)")[![hollodk](https://avatars.githubusercontent.com/u/651271?v=4)](https://github.com/hollodk "hollodk (3 commits)")

### Embed Badge

![Health badge](/badges/jmather-symfony-sonata-distribution/health.svg)

```
[![Health](https://phpackages.com/badges/jmather-symfony-sonata-distribution/health.svg)](https://phpackages.com/packages/jmather-symfony-sonata-distribution)
```

###  Alternatives

[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[contao/core-bundle

Contao Open Source CMS

1231.6M2.4k](/packages/contao-core-bundle)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
