Skip to content

Commit 9d40373

Browse files
author
Andras Ratz
committed
base commit
1 parent fd8c20a commit 9d40373

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

52 files changed

+4632
-2
lines changed

.gitignore

+15
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
/web/bundles/
2+
/app/config/parameters.yml
3+
/var/bootstrap.php.cache
4+
/var/cache/*
5+
/var/logs/*
6+
!var/cache/.gitkeep
7+
!var/logs/.gitkeep
8+
/build/
9+
/vendor/
10+
/bin/*
11+
!bin/console
12+
!bin/symfony_requirements
13+
/composer.phar
14+
15+
\.idea/

.travis.yml

+11
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
language: php
2+
3+
php:
4+
- 5.3.3
5+
- 5.3
6+
- 5.4
7+
- 5.5
8+
- 5.6
9+
10+
before_script: composer install -n
11+

LICENSE

+19
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
Copyright (c) 2004-2013 Fabien Potencier
2+
3+
Permission is hereby granted, free of charge, to any person obtaining a copy
4+
of this software and associated documentation files (the "Software"), to deal
5+
in the Software without restriction, including without limitation the rights
6+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
7+
copies of the Software, and to permit persons to whom the Software is furnished
8+
to do so, subject to the following conditions:
9+
10+
The above copyright notice and this permission notice shall be included in all
11+
copies or substantial portions of the Software.
12+
13+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
14+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
15+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
16+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
17+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
18+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
19+
THE SOFTWARE.

README.md

+170-2
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,170 @@
1-
symfony-bug
2-
===========
1+
Symfony Standard Edition
2+
========================
3+
4+
Welcome to the Symfony Standard Edition - a fully-functional Symfony2
5+
application that you can use as the skeleton for your new applications.
6+
7+
This document contains information on how to download, install, and start
8+
using Symfony. For a more detailed explanation, see the [Installation][1]
9+
chapter of the Symfony Documentation.
10+
11+
1) Installing the Standard Edition
12+
----------------------------------
13+
14+
When it comes to installing the Symfony Standard Edition, you have the
15+
following options.
16+
17+
### Use Composer (*recommended*)
18+
19+
As Symfony uses [Composer][2] to manage its dependencies, the recommended way
20+
to create a new project is to use it.
21+
22+
If you don't have Composer yet, download it following the instructions on
23+
http://getcomposer.org/ or just run the following command:
24+
25+
curl -s http://getcomposer.org/installer | php
26+
27+
Then, use the `create-project` command to generate a new Symfony application:
28+
29+
php composer.phar create-project symfony/framework-standard-edition path/to/install
30+
31+
Composer will install Symfony and all its dependencies under the
32+
`path/to/install` directory.
33+
34+
### Download an Archive File
35+
36+
To quickly test Symfony, you can also download an [archive][3] of the Standard
37+
Edition and unpack it somewhere under your web server root directory.
38+
39+
If you downloaded an archive "without vendors", you also need to install all
40+
the necessary dependencies. Download composer (see above) and run the
41+
following command:
42+
43+
php composer.phar install
44+
45+
2) Checking your System Configuration
46+
-------------------------------------
47+
48+
Before starting coding, make sure that your local system is properly
49+
configured for Symfony.
50+
51+
Execute the `check.php` script from the command line:
52+
53+
php app/check.php
54+
55+
The script returns a status code of `0` if all mandatory requirements are met,
56+
`1` otherwise.
57+
58+
Access the `config.php` script from a browser:
59+
60+
http://localhost/path-to-project/web/config.php
61+
62+
If you get any warnings or recommendations, fix them before moving on.
63+
64+
3) Browsing the Demo Application
65+
--------------------------------
66+
67+
Congratulations! You're now ready to use Symfony.
68+
69+
From the `config.php` page, click the "Bypass configuration and go to the
70+
Welcome page" link to load up your first Symfony page.
71+
72+
You can also use a web-based configurator by clicking on the "Configure your
73+
Symfony Application online" link of the `config.php` page.
74+
75+
To see a real-live Symfony page in action, access the following page:
76+
77+
web/app_dev.php/demo/hello/Fabien
78+
79+
4) Getting started with Symfony
80+
-------------------------------
81+
82+
This distribution is meant to be the starting point for your Symfony
83+
applications, but it also contains some sample code that you can learn from
84+
and play with.
85+
86+
A great way to start learning Symfony is via the [Quick Tour][4], which will
87+
take you through all the basic features of Symfony2.
88+
89+
Once you're feeling good, you can move onto reading the official
90+
[Symfony2 book][5].
91+
92+
A default bundle, `AcmeDemoBundle`, shows you Symfony2 in action. After
93+
playing with it, you can remove it by following these steps:
94+
95+
* delete the `src/Acme` directory;
96+
97+
* remove the routing entry referencing AcmeDemoBundle in `app/config/routing_dev.yml`;
98+
99+
* remove the AcmeDemoBundle from the registered bundles in `app/AppKernel.php`;
100+
101+
* remove the `web/bundles/acmedemo` directory;
102+
103+
* empty the `security.yml` file or tweak the security configuration to fit
104+
your needs.
105+
106+
What's inside?
107+
---------------
108+
109+
The Symfony Standard Edition is configured with the following defaults:
110+
111+
* Twig is the only configured template engine;
112+
113+
* Doctrine ORM/DBAL is configured;
114+
115+
* Swiftmailer is configured;
116+
117+
* Annotations for everything are enabled.
118+
119+
It comes pre-configured with the following bundles:
120+
121+
* **FrameworkBundle** - The core Symfony framework bundle
122+
123+
* [**SensioFrameworkExtraBundle**][6] - Adds several enhancements, including
124+
template and routing annotation capability
125+
126+
* [**DoctrineBundle**][7] - Adds support for the Doctrine ORM
127+
128+
* [**TwigBundle**][8] - Adds support for the Twig templating engine
129+
130+
* [**SecurityBundle**][9] - Adds security by integrating Symfony's security
131+
component
132+
133+
* [**SwiftmailerBundle**][10] - Adds support for Swiftmailer, a library for
134+
sending emails
135+
136+
* [**MonologBundle**][11] - Adds support for Monolog, a logging library
137+
138+
* [**AsseticBundle**][12] - Adds support for Assetic, an asset processing
139+
library
140+
141+
* **WebProfilerBundle** (in dev/test env) - Adds profiling functionality and
142+
the web debug toolbar
143+
144+
* **SensioDistributionBundle** (in dev/test env) - Adds functionality for
145+
configuring and working with Symfony distributions
146+
147+
* [**SensioGeneratorBundle**][13] (in dev/test env) - Adds code generation
148+
capabilities
149+
150+
* **AcmeDemoBundle** (in dev/test env) - A demo bundle with some example
151+
code
152+
153+
All libraries and bundles included in the Symfony Standard Edition are
154+
released under the MIT or BSD license.
155+
156+
Enjoy!
157+
158+
[1]: http://symfony.com/doc/2.4/book/installation.html
159+
[2]: http://getcomposer.org/
160+
[3]: http://symfony.com/download
161+
[4]: http://symfony.com/doc/2.4/quick_tour/the_big_picture.html
162+
[5]: http://symfony.com/doc/2.4/index.html
163+
[6]: http://symfony.com/doc/2.4/bundles/SensioFrameworkExtraBundle/index.html
164+
[7]: http://symfony.com/doc/2.4/book/doctrine.html
165+
[8]: http://symfony.com/doc/2.4/book/templating.html
166+
[9]: http://symfony.com/doc/2.4/book/security.html
167+
[10]: http://symfony.com/doc/2.4/cookbook/email.html
168+
[11]: http://symfony.com/doc/2.4/cookbook/logging/monolog.html
169+
[12]: http://symfony.com/doc/2.4/cookbook/assetic/asset_management.html
170+
[13]: http://symfony.com/doc/2.4/bundles/SensioGeneratorBundle/index.html

UPGRADE-2.2.md

+30
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
UPGRADE FROM 2.1 to 2.2
2+
=======================
3+
4+
* The [`web/.htaccess`](https://github.com/symfony/symfony-standard/blob/2.2/web/.htaccess)
5+
file has been enhanced substantially to prevent duplicate content with and
6+
without `/app.php` in the URI. It also improves functionality when using
7+
Apache aliases or when mod_rewrite is not available. So you might want to
8+
update your `.htaccess` file as well.
9+
10+
* The ``_internal`` route is not used any more. It should then be removed
11+
from both your routing and security configurations. A ``fragments`` key has
12+
been added to the framework configuration and must be specified when ESI or
13+
Hinclude are in use. No security configuration is required for this path as
14+
by default ESI access is only permitted for trusted hosts and Hinclude
15+
access uses an URL signing mechanism.
16+
17+
```
18+
framework:
19+
# ...
20+
fragments: { path: /_proxy }
21+
```
22+
23+
Functional Tests
24+
----------------
25+
26+
* The profiler has been disabled by default in the test environment. You can
27+
enable it again by modifying the ``config_test.yml`` configuration file or
28+
even better, you can just enable it for the very next request by calling
29+
``$client->enableProfiler()`` when you need the profiler in a test (that
30+
speeds up functional tests quite a bit).

UPGRADE-2.3.md

+52
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
UPGRADE FROM 2.2 to 2.3
2+
=======================
3+
4+
When upgrading Symfony from 2.2 to 2.3, you need to do the following changes
5+
to the code that came from the Standard Edition:
6+
7+
* The debugging tools are not enabled by default anymore and should be added
8+
to the
9+
[`web/app_dev.php`](https://github.com/symfony/symfony-standard/blob/2.3/web/app_dev.php)
10+
front controller manually, just after including the bootstrap cache:
11+
12+
use Symfony\Component\Debug\Debug;
13+
14+
Debug::enable();
15+
16+
You also need to enable debugging in the
17+
[`app/console`](https://github.com/symfony/symfony-standard/blob/2.3/app/console)
18+
script, after the `$debug` variable is defined:
19+
20+
use Symfony\Component\Debug\Debug;
21+
22+
if ($debug) {
23+
Debug::enable();
24+
}
25+
26+
* The `parameters.yml` file can now be managed by the
27+
`incenteev/composer-parameter-handler` bundle that comes with the 2.3
28+
Standard Edition:
29+
30+
* add `"incenteev/composer-parameter-handler": "~2.0"` to your
31+
`composer.json` file;
32+
33+
* add `/app/config/parameters.yml` to your `.gitignore` file;
34+
35+
* create a
36+
[`app/config/parameters.yml.dist`](https://github.com/symfony/symfony-standard/blob/2.3/app/config/parameters.yml.dist)
37+
file with sensible values for all your parameters.
38+
39+
* It is highly recommended that you switch the minimum stability to `stable`
40+
in your `composer.json` file.
41+
42+
* If you are using Apache, have a look at the new
43+
[`.htaccess`](https://github.com/symfony/symfony-standard/blob/2.3/web/.htaccess)
44+
configuration and change yours accordingly.
45+
46+
* In the
47+
[`app/autoload.php`](https://github.com/symfony/symfony-standard/blob/2.3/app/autoload.php)
48+
file, the section about `intl` should be removed as it is not needed anymore.
49+
50+
You can also have a look at the
51+
[diff](https://github.com/symfony/symfony-standard/compare/v2.2.0%E2%80%A62.3)
52+
between the 2.2 version of the Standard Edition and the 2.3 version.

UPGRADE-2.4.md

+9
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
UPGRADE FROM 2.3 to 2.4
2+
=======================
3+
4+
When upgrading Symfony from 2.3 to 2.4, you need to do the following changes
5+
to the code that came from the Standard Edition:
6+
7+
* We recommend to comment or remove the `firephp` and `chromephp` Monolog
8+
handlers as they might cause issues with some configuration (`chromephp`
9+
with Nginx for instance).

0 commit comments

Comments
 (0)