Archived

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 4923483805 merged branch stof/autoloader_refactoring (PR #3756 ) Commits ------- `f1f1494` Added an exception when passing an invalid object to ApcClassLoader `f5cb167` [ClassLoader] Added a DebugClassLoader using composition `0e54a22` Updated the changelog `eae772e` [ClassLoader] Added an ApcClassLoader `4d1333f` Changed the test autoloading to use the new autoloader `09850bd` [ClassLoader] Added a simplified PSR-0 ClassLoader Discussion ---------- Autoloader refactoring Bug fix: no Feature addition: yes Backwards compatibility break: no Symfony2 tests pass: [![Build Status](https://secure.travis-ci.org/stof/symfony.png?branch=autoloader_refactoring)](http://travis-ci.org/stof/symfony) As discussed in #3623, I added a new ClassLoader instead of modifying the UniversalClassLoader, to be able to use the method names without BC concerns. The new class works the same than the composer autoloader regarding the handling of fallbacks, to be able to reuse namespace maps generated by composer. ```php <?php // autoload.php require_once __DIR__.'/vendor/symfony/class-loader/Symfony/Component/ClassLoader/ClassLoader.php'; $loader = new Symfony\Component\ClassLoader\ClassLoader(); $map = require __DIR__.'/vendor/.composer/autoload_namespaces.php'; $loader->addPrefixes($map); $loader->register(); ``` Differences with the composer class loader: - Composer's ``add`` method is named ``addPrefix`` in the Symfony ClassLoader - the methods related to the class map are removed as Symfony has a separate laoder for class maps - the ``addPrefixes`` method is added, accepting a namespace map. I also added a new ApcClassLoader which uses composition instead of inheriting from a class loader, which makes it far more easier to reuse (we could wrap a Composer autoloader with it for instance). ```php <?php $composerLoader = require __DIR__.'/vendor/.composer/autoload.php'; // no need to require the file manually as Composer already registered its autoloader $cachedLoader = new Symfony\Component\ClassLoader\ApcClassLoader('autoload.my_app', $composerLoader); $cachedLoader->register(); // unregister the Composer autoloader as we wrapped it in the ApcClassLoader $composerLoader->unregister(); ``` TODO: - refactor the Debug class loader to use composition too to be able to support different class loaders --------------------------------------------------------------------------- by fabpot at 2012-04-02T16:31:28Z Can you update the CHANGELOG and the UPGRADE file accordingly? --------------------------------------------------------------------------- by stof at 2012-04-02T16:47:43Z I added a note in the CHANGELOG. There is nothing to add in the UPGRADE file as the change is fully BC (I did not change the UniversalClassLoader at all so it can still be used). I'm working on the Debug loader right now so please wait a bit before merging --------------------------------------------------------------------------- by stof at 2012-04-02T17:12:11Z Here is a new DebugClassLoader using composition too. this way, it is able to support the UniversalClassLoader, the ApcUniversalClassLoader (without dropping the use of APC as done previously), the new ClassLoader, the new ApcClassLoader and even the composer autoloader. I'm not sure about the use of ``method_exists`` as it could break if an autoloader implements a protected ``findFile`` method (crappy PHP 😢) but hardcoding the supported classes would be a pain and requiring an interface would make the autoloaders more difficult to use (as the interface would need to be required first) and would drop the support of the composer autoloader.		2012-04-02 20:28:07 +02:00
src/Symfony	merged branch stof/autoloader_refactoring (PR #3756 )	2012-04-02 20:28:07 +02:00
.gitignore	Added vendor directory to .gitignore	2010-06-24 10:44:28 +02:00
.travis.yml	also test PHP 5.3.2, since this is the official lowest supported PHP version	2011-12-26 01:15:21 +01:00
autoload.php.dist	Changed the test autoloading to use the new autoloader	2012-04-01 23:50:54 +02:00
CHANGELOG-2.0.md	updated CHANGELOG for 2.0.12	2012-03-19 00:56:33 +01:00
CHANGELOG-2.1.md	merged branch stof/autoloader_refactoring (PR #3756 )	2012-04-02 20:28:07 +02:00
check_cs	moved component and bridge unit tests to the src/ directory	2012-03-29 08:37:22 +02:00
composer.json	fixed typos in composer file	2012-03-15 11:15:25 +01:00
CONTRIBUTORS.md	update CONTRIBUTORS for 2.0.12	2012-03-19 00:57:27 +01:00
LICENSE	Updated LICENSE files copyright	2012-02-22 10:10:37 +01:00
phpunit.xml.dist	moved component and bridge unit tests to the src/ directory	2012-03-29 08:37:22 +02:00
README.md	set travis-ci icon to master	2011-11-23 11:36:09 +01:00
UPGRADE-2.1.md	typo fix in upgrading guide	2012-03-25 18:27:20 -03:00
vendors.php	updated license blocks	2012-03-31 18:00:32 -03: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.2 and up.

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.