-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
rangakomarthicomo
committed
Nov 7, 2013
1 parent
6690ff7
commit a3b18f6
Showing
8,023 changed files
with
698,794 additions
and
2 deletions.
The diff you're trying to view is too large. We only load the first 3000 changed files.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,19 @@ | ||
Copyright (c) 2004-2013 Fabien Potencier | ||
|
||
Permission is hereby granted, free of charge, to any person obtaining a copy | ||
of this software and associated documentation files (the "Software"), to deal | ||
in the Software without restriction, including without limitation the rights | ||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | ||
copies of the Software, and to permit persons to whom the Software is furnished | ||
to do so, subject to the following conditions: | ||
|
||
The above copyright notice and this permission notice shall be included in all | ||
copies or substantial portions of the Software. | ||
|
||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | ||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | ||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | ||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | ||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | ||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN | ||
THE SOFTWARE. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,171 @@ | ||
SuperMarket | ||
=========== | ||
Symfony Standard Edition | ||
======================== | ||
|
||
Welcome to the Symfony Standard Edition - a fully-functional Symfony2 | ||
application that you can use as the skeleton for your new applications. | ||
|
||
This document contains information on how to download, install, and start | ||
using Symfony. For a more detailed explanation, see the [Installation][1] | ||
chapter of the Symfony Documentation. | ||
|
||
1) Installing the Standard Edition | ||
---------------------------------- | ||
|
||
When it comes to installing the Symfony Standard Edition, you have the | ||
following options. | ||
|
||
### Use Composer (*recommended*) | ||
|
||
As Symfony uses [Composer][2] 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 | ||
http://getcomposer.org/ or just run the following command: | ||
|
||
curl -s http://getcomposer.org/installer | php | ||
|
||
Then, use the `create-project` command to generate a new Symfony application: | ||
|
||
php composer.phar create-project symfony/framework-standard-edition path/to/install | ||
|
||
Composer will install Symfony and all its dependencies under the | ||
`path/to/install` directory. | ||
|
||
### Download an Archive File | ||
|
||
To quickly test Symfony, you can also download an [archive][3] of the Standard | ||
Edition and unpack it somewhere under your web server root directory. | ||
|
||
If you downloaded an archive "without vendors", 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 | ||
|
||
The script returns a status code of `0` if all mandatory requirements are met, | ||
`1` otherwise. | ||
|
||
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) Browsing the Demo Application | ||
-------------------------------- | ||
|
||
Congratulations! You're now ready to use Symfony. | ||
|
||
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][4], 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][5]. | ||
|
||
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 entry referencing AcmeDemoBundle in `app/config/routing_dev.yml`; | ||
|
||
* remove the AcmeDemoBundle 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? | ||
--------------- | ||
|
||
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**][6] - Adds several enhancements, including | ||
template and routing annotation capability | ||
|
||
* [**DoctrineBundle**][7] - Adds support for the Doctrine ORM | ||
|
||
* [**TwigBundle**][8] - Adds support for the Twig templating engine | ||
|
||
* [**SecurityBundle**][9] - Adds security by integrating Symfony's security | ||
component | ||
|
||
* [**SwiftmailerBundle**][10] - Adds support for Swiftmailer, a library for | ||
sending emails | ||
|
||
* [**MonologBundle**][11] - Adds support for Monolog, a logging library | ||
|
||
* [**AsseticBundle**][12] - Adds support for Assetic, an asset processing | ||
library | ||
|
||
* **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**][13] (in dev/test env) - Adds code generation | ||
capabilities | ||
|
||
* **AcmeDemoBundle** (in dev/test env) - A demo bundle with some example | ||
code | ||
|
||
All libraries and bundles included in the Symfony Standard Edition are | ||
released under the MIT or BSD license. | ||
|
||
Enjoy! | ||
|
||
[1]: http://symfony.com/doc/2.3/book/installation.html | ||
[2]: http://getcomposer.org/ | ||
[3]: http://symfony.com/download | ||
[4]: http://symfony.com/doc/2.3/quick_tour/the_big_picture.html | ||
[5]: http://symfony.com/doc/2.3/index.html | ||
[6]: http://symfony.com/doc/2.3/bundles/SensioFrameworkExtraBundle/index.html | ||
[7]: http://symfony.com/doc/2.3/book/doctrine.html | ||
[8]: http://symfony.com/doc/2.3/book/templating.html | ||
[9]: http://symfony.com/doc/2.3/book/security.html | ||
[10]: http://symfony.com/doc/2.3/cookbook/email.html | ||
[11]: http://symfony.com/doc/2.3/cookbook/logging/monolog.html | ||
[12]: http://symfony.com/doc/2.3/cookbook/assetic/asset_management.html | ||
[13]: http://symfony.com/doc/2.3/bundles/SensioGeneratorBundle/index.html |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,30 @@ | ||
UPGRADE FROM 2.1 to 2.2 | ||
======================= | ||
|
||
* The [`web/.htaccess`](https://github.com/symfony/symfony-standard/blob/2.2/web/.htaccess) | ||
file has been enhanced substantially to prevent duplicate content with and | ||
without `/app.php` in the URI. It also improves functionality when using | ||
Apache aliases or when mod_rewrite is not available. So you might want to | ||
update your `.htaccess` file as well. | ||
|
||
* The ``_internal`` route is not used any more. It should then be removed | ||
from both your routing and security configurations. A ``fragments`` key has | ||
been added to the framework configuration and must be specified when ESI or | ||
Hinclude are in use. No security configuration is required for this path as | ||
by default ESI access is only permitted for trusted hosts and Hinclude | ||
access uses an URL signing mechanism. | ||
|
||
``` | ||
framework: | ||
# ... | ||
fragments: { path: /_proxy } | ||
``` | ||
|
||
Functional Tests | ||
---------------- | ||
|
||
* The profiler has been disabled by default in the test environment. You can | ||
enable it again by modifying the ``config_test.yml`` configuration file or | ||
even better, you can just enable it for the very next request by calling | ||
``$client->enableProfiler()`` when you need the profiler in a test (that | ||
speeds up functional tests quite a bit). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,52 @@ | ||
UPGRADE FROM 2.2 to 2.3 | ||
======================= | ||
|
||
When upgrading Symfony from 2.2 to 2.3, you need to do the following changes | ||
to the code that came from the Standard Edition: | ||
|
||
* The debugging tools are not enabled by default anymore and should be added | ||
to the | ||
[`web/app_dev.php`](https://github.com/symfony/symfony-standard/blob/2.3/web/app_dev.php) | ||
front controller manually, just after including the bootstrap cache: | ||
|
||
use Symfony\Component\Debug\Debug; | ||
|
||
Debug::enable(); | ||
|
||
You also need to enable debugging in the | ||
[`app/console`](https://github.com/symfony/symfony-standard/blob/2.3/app/console) | ||
script, after the `$debug` variable is defined: | ||
|
||
use Symfony\Component\Debug\Debug; | ||
|
||
if ($debug) { | ||
Debug::enable(); | ||
} | ||
|
||
* The `parameters.yml` file can now be managed by the | ||
`incenteev/composer-parameter-handler` bundle that comes with the 2.3 | ||
Standard Edition: | ||
|
||
* add `"incenteev/composer-parameter-handler": "~2.0"` to your | ||
`composer.json` file; | ||
|
||
* add `/app/config/parameters.yml` to your `.gitignore` file; | ||
|
||
* create a | ||
[`app/config/parameters.yml.dist`](https://github.com/symfony/symfony-standard/blob/2.3/app/config/parameters.yml.dist) | ||
file with sensible values for all your parameters. | ||
|
||
* It is highly recommended that you switch the minimum stability to `stable` | ||
in your `composer.json` file. | ||
|
||
* If you are using Apache, have a look at the new | ||
[`.htaccess`](https://github.com/symfony/symfony-standard/blob/2.3/web/.htaccess) | ||
configuration and change yours accordingly. | ||
|
||
* In the | ||
[`app/autoload.php`](https://github.com/symfony/symfony-standard/blob/2.3/app/autoload.php) | ||
file, the section about `intl` should be removed as it is not needed anymore. | ||
|
||
You can also have a look at the | ||
[diff](https://github.com/symfony/symfony-standard/compare/v2.2.0%E2%80%A62.3) | ||
between the 2.2 version of the Standard Edition and the 2.3 version. |
Oops, something went wrong.