forked from https://github.com/symfony/symfony

This repository has been archived on 2023-08-20. You can view files and clone it, but cannot push or open issues or pull requests.

Go to file

Fabien Potencier 89f9b24575 merged branch fabpot/routing-options (PR #6738 ) This PR was merged into the master branch. Commits ------- `9fc7def` added the UPGRADE file for Symfony 3.0 `e84cad2` [Routing] updated CHANGELOG `65eca8a` [Routing] added new schemes and methods options to the annotation loader `5082994` [Routing] renamed pattern to path `b357caf` [Routing] renamed hostname pattern to just hostname `e803f46` made schemes and methods available in XmlFileLoader `d374e70` made schemes and methods available in YamlFileLoader `2834e7e` added scheme and method setter in RouteCollection `10183de` make scheme and method requirements first-class citizen in Route Discussion ---------- Routing options \| Q \| A \| ------------- \| --- \| Bug fix? \| no \| New feature? \| no \| BC breaks? \| no \| Deprecations? \| yes \| Tests pass? \| yes \| Fixed tickets \| #5989, #5990, #6049 \| License \| MIT In #5989, it has unanimously been decided to renamed `hostname_pattern` to `hostname` and `pattern` to `path`. That makes a lot of sense and I would like to do the renaming now as `hostname_pattern` is new in Symfony 2.2, so I'd like to avoid breaking BC just after the release. As we are modifying the route options, I've also included changes introduced by @Tobion in #6049 which were discussed in #5990. As everything is BC, I think it's wise to include that in 2.2. What do you think? --------------------------------------------------------------------------- by Tobion at 2013-01-14T18:25:53Z I agree it should be done in 2.2. Thanks for working on it. --------------------------------------------------------------------------- by vicb at 2013-01-14T23:11:12Z @fabpot "Everything is BC" until it breaks BC in 3.0, that's why I'd like to see [deprecations in PR summary](https://github.com/symfony/symfony-docs/pull/2116) what do you think ? --------------------------------------------------------------------------- by vicb at 2013-01-14T23:16:40Z it would also be great to update the CHANGELOG with deprecations (it could also help people answering your question) --------------------------------------------------------------------------- by fabpot at 2013-01-15T07:07:03Z @vicb: I've just updated the CHANGELOG and created the UPGRADE file for 3.0. --------------------------------------------------------------------------- by vicb at 2013-01-15T07:15:32Z @fabpot thanks.		2013-01-15 17:25:04 +01:00
src/Symfony	merged branch fabpot/routing-options (PR #6738 )	2013-01-15 17:25:04 +01:00
.editorconfig	Add EditorConfig File	2012-06-16 14:08:15 +02:00
.gitignore	ignore composer.phar	2012-04-20 14:10:06 +01:00
.travis.yml	Merge branch '2.1'	2013-01-05 16:33:05 +01:00
CHANGELOG-2.0.md	updated CHANGELOG for 2.0.21	2012-12-21 11:10:50 +01:00
CHANGELOG-2.1.md	updated CHANGELOG for 2.1.6	2012-12-21 11:24:34 +01:00
CONTRIBUTING.md	Making it easier to grab the PR template.	2012-12-15 21:57:27 +00:00
CONTRIBUTORS.md	update CONTRIBUTORS for 2.0.20	2012-12-20 08:50:28 +01:00
LICENSE	updated license year	2013-01-04 17:59:43 +01:00
README.md	Merge branch '2.0' into 2.1	2012-12-20 08:21:29 +01:00
UPGRADE-2.1.md	Merge branch '2.1'	2012-11-29 11:32:45 +01:00
UPGRADE-2.2.md	fixed typo	2013-01-14 16:03:02 -08:00
UPGRADE-3.0.md	added the UPGRADE file for Symfony 3.0	2013-01-15 17:22:42 +01:00
autoload.php.dist	[travis-ci] Zend Garbage Collection only for PHP5.4	2012-11-19 15:21:43 +01:00
composer.json	[Monolog] Mark old non-PSR3 methods as deprecated	2013-01-09 10:19:50 +01:00
phpunit.xml.dist	[travis-ci] Zend Garbage Collection only for PHP5.4	2012-11-19 15:21:43 +01:00

README.md

README

What is Symfony2?

Symfony2 is a PHP 5.3 full-stack web framework. It is written with speed and flexibility in mind. It allows developers to build better and easy to maintain websites with PHP.

Symfony can be used to develop all kind of websites, from your personal blog to high traffic ones like Dailymotion or Yahoo! Answers.

Requirements

Symfony2 is only supported on PHP 5.3.3 and up.

Be warned that PHP versions before 5.3.8 are known to be buggy and might not work for you:

before PHP 5.3.4, if you get "Notice: Trying to get property of non-object", you've hit a known PHP bug (see https://bugs.php.net/bug.php?id=52083 and https://bugs.php.net/bug.php?id=50027);
before PHP 5.3.8, if you get an error involving annotations, you've hit a known PHP bug (see https://bugs.php.net/bug.php?id=55156).

Installation

The best way to install Symfony2 is to download the Symfony Standard Edition available at http://symfony.com/download.

Documentation

The "Quick Tour" tutorial gives you a first feeling of the framework. If, like us, you think that Symfony2 can help speed up your development and take the quality of your work to the next level, read the official Symfony2 documentation.

Contributing

Symfony2 is an open source, community-driven project. If you'd like to contribute, please read the Contributing Code part of the documentation. If you're submitting a pull request, please follow the guidelines in the Submitting a Patch section and use Pull Request Template.

Running Symfony2 Tests

Information on how to run the Symfony2 test suite can be found in the Running Symfony2 Tests section.