|
|
@@ -1,44 +1,44 @@
|
|
|
-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][1].
|
|
|
-
|
|
|
-Documentation
|
|
|
--------------
|
|
|
-
|
|
|
-The "[Quick Tour][2]" 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][3].
|
|
|
-
|
|
|
-Contributing
|
|
|
-------------
|
|
|
-
|
|
|
-Symfony2 is an open source, community-driven project. If you'd like to contribute,
|
|
|
-please read the [Contributing Code][4] part of the documentation. If you're submitting
|
|
|
-a pull request, please follow the guidelines in the [Submitting a Patch][5] section.
|
|
|
-
|
|
|
-[1]: http://symfony.com/download
|
|
|
-[2]: http://symfony.com/get_started
|
|
|
-[3]: http://symfony.com/doc/current/
|
|
|
-[4]: http://symfony.com/doc/current/contributing/code/index.html
|
|
|
-[5]: http://symfony.com/doc/current/contributing/code/patches.html#check-list
|
|
|
+Console Component
|
|
|
+=================
|
|
|
+
|
|
|
+Even if we are talking about a web framework, having some tools to manage
|
|
|
+your project from the command line is nice. In Symfony2, we use the console
|
|
|
+to generate CRUDs, update the database schema, etc. It's not required, but
|
|
|
+it is really convenient and it can boost your productivity a lot.
|
|
|
+
|
|
|
+This example shows how to create a command line tool very easily:
|
|
|
+
|
|
|
+```
|
|
|
+use Symfony\Component\Console\Application;
|
|
|
+use Symfony\Component\Console\Input\InputInterface;
|
|
|
+use Symfony\Component\Console\Input\InputArgument;
|
|
|
+use Symfony\Component\Console\Input\InputOption;
|
|
|
+use Symfony\Component\Console\Output\OutputInterface;
|
|
|
+
|
|
|
+$console = new Application();
|
|
|
+$console
|
|
|
+ ->register('ls')
|
|
|
+ ->setDefinition(array(
|
|
|
+ new InputArgument('dir', InputArgument::REQUIRED, 'Directory name'),
|
|
|
+ ))
|
|
|
+ ->setDescription('Displays the files in the given directory')
|
|
|
+ ->setCode(function (InputInterface $input, OutputInterface $output) {
|
|
|
+ $dir = $input->getArgument('dir');
|
|
|
+
|
|
|
+ $output->writeln(sprintf('Dir listing for <info>%s</info>', $dir));
|
|
|
+ })
|
|
|
+;
|
|
|
+
|
|
|
+$console->run();
|
|
|
+```
|
|
|
+
|
|
|
+With only 10 lines of code or so, you have access to a lot of features like output
|
|
|
+coloring, input and output abstractions (so that you can easily unit-test your
|
|
|
+commands), validation, automatic help messages, and a lot more. It's really powerful.
|
|
|
+
|
|
|
+Resources
|
|
|
+---------
|
|
|
+
|
|
|
+Unit tests:
|
|
|
+
|
|
|
+https://github.com/symfony/symfony/tree/master/tests/Symfony/Tests/Component/Console
|
Lukas Kahwe Smith