atom.xml

<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">

  <title><![CDATA[Elcodi blog]]></title>
  <link href="http://elcodi-blog.github.io/atom.xml" rel="self"/>
  <link href="http://elcodi-blog.github.io/"/>
  <updated>2016-02-09T16:05:34+01:00</updated>
  <id>http://elcodi-blog.github.io/</id>
  <author>
    <name><![CDATA[Elcodi Team]]></name>
    
  </author>
  <generator uri="http://octopress.org/">Octopress</generator>

  
  <entry>
    <title type="html"><![CDATA[Purchasable Architecture]]></title>
    <link href="http://elcodi-blog.github.io/blog/2016/02/02/purchasable-architecture/"/>
    <updated>2016-02-02T16:20:49+01:00</updated>
    <id>http://elcodi-blog.github.io/blog/2016/02/02/purchasable-architecture</id>
    <content type="html"><![CDATA[<p>It&rsquo;s been a long time since our last blog post, but we have some very good news
to share with you.</p>

<p>During the last months we&rsquo;ve been working on new projects for Elcodi. Some of
them are not available yet, but some of them have been merged recently. This
post is basically to show you what has changed and improved in Elcodi and to
spread the word about our new Roadmap for the next months. This roadmap is
exactly the same one, but with different dates due to these new changes.</p>

<h3>Purchasable</h3>

<p>From almost the beginning of the life of our project, and because the entity
product and related ones are one of the main topic of all e-commerce projects,
we have tried to manage how abstract should be all this entity family. For
example, should we create a Purchasable interface to be used in Cart and Order?
Should we use only one entity to manage all kind of purchasable entities? Should
we use traits for that? How many interfaces?</p>

<p>Like all software projects, this is a question that can be solved in several
ways. One of these ways is analyzing our needs and creating a software model
from these needs. Of course, this is the right way if you have time, money and
resources. Another way is just by trying one approach. Working with it, dealing
with it as much as possible, and listening yourself, looking for your needs.
This approach needs time, only time, and the capacity of refactoring, of action,
of change.</p>

<p>Well. This one, the last one, is the approach we&rsquo;ve used some time ago. At the
beginning, using two entities, Product and Variant, to define both purchasable
types has been a good choice. And it&rsquo;s been like this until now. Since some
months ago, one of the most asked questions have been&hellip; <em>well, how can I create
my own purchasable?</em>, and with this approach, was not simple, was not logical.</p>

<p>Well. We have reacted and a new Purchasable implementation is here.</p>

<p>Instead of dealing with products and variants, Elcodi&rsquo;s cart is going to deal
only with purchasable implementations. We&rsquo;ve started using Doctrine CTI (Class
Table Inheritance) to allow other implementation coexist with current ones, so
if you need to work with your own purchasable implementation&hellip; just create it,
implement this interface and it&rsquo;s done :)</p>

<p>That simple!</p>

<h3>Elcodi v2.0.0</h3>

<p>Our Roadmap was clear. Elcodi <em>v1.1.0</em> had to be tagged the first of January,
but we really wanted this feature to be available and in master as soon as
possible.</p>

<p>A change like that can needs a major version change, and even we know that is
too soon to create a new major version, we think that this is the best for the
project and the best for our evolution.</p>

<p>We are not specialists in maintaining several branches at all, so we will not
support versions <em>v1.0</em> actively. What we will do for sure is supporting somehow
all projects that want to go from <em>v1.0</em> to <em>v2.0</em>. At this moment we don&rsquo;t have
any tool for that but, if there are some requests, we will do it for sure.</p>

<p>So, if you need us, just <a href="http://gitter.im/elcodi/elcodi">Ask for help</a></p>

<h3>New Roadmap</h3>

<p>Of course our roadmap has changed, but only with dates.<br/>
Let&rsquo;s take a look at the new plan.</p>

<h4>v2.1</h4>

<ul>
<li>Released the 1st of June, 2016</li>
<li>Search engine using ElasticSearch will be introduced here</li>
<li>Product API will be added</li>
<li>User API will be added</li>
<li>Cart API will be added</li>
<li>Some Media improvements, like new media types</li>
<li>New shop template will be added</li>
<li>Back panel documentation</li>
<li>Code Coverage of all components and bundles over 60%</li>
<li>Templates documentation</li>
</ul>


<h4>v2.2</h4>

<ul>
<li>Released the 1st of September, 2016</li>
<li>Multistore. Switch between stores in the same installation</li>
<li>Shop API will be added</li>
<li>New shop template will be added</li>
<li>New tempates and plugins website with tons of cool new stuff for all Elcodi and Bamboo implementations</li>
<li>Code Coverage of all components and bundles over 70%</li>
</ul>


<h4>v2.3</h4>

<ul>
<li>Released the 1st of January, 2017</li>
<li>We will remove all deprecated code</li>
<li>Bamboo will use Symfony3 and maybe new version of Doctrine</li>
<li>Updated all dependencies</li>
<li>Marketplace</li>
<li>Elcodi community site will be created.</li>
<li>Unknown bunch of new and cool stuff</li>
<li>Code Coverage of all components and bundles over 80%</li>
</ul>


<h3>Try us</h3>

<p>You can start using Elcodi in a very very fast way, just&hellip; DO IT!</p>

<p><a href="http://elcodi.io/docs/quick-start/">Install Elcodi</a></p>

<h3>Last thoughts</h3>

<p>Well, Elcodi project is keep doing. Remember that we need a lot of help, and we
really want you to test our project, take a small tour around what we offer and
if you like, only if you like&hellip;</p>

<ul>
<li><a href="https://github.com/elcodi/elcodi">Star us</a></li>
<li><a href="https://gitter.com/elcodi/elcodi">Join us</a></li>
<li><a href="https://github.com/elcodi/elcodi/issues">Help us</a></li>
</ul>

]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[Suggest our next features]]></title>
    <link href="http://elcodi-blog.github.io/blog/2015/11/23/suggest-our-next-features/"/>
    <updated>2015-11-23T17:13:35+01:00</updated>
    <id>http://elcodi-blog.github.io/blog/2015/11/23/suggest-our-next-features</id>
    <content type="html"><![CDATA[<p>For sure some of you already know about
<a href="http://blog.elcodi.io/blog/2015/11/20/elcodi-online-meetup/">Elcodi&rsquo;s first online meetup</a>.
It will be next November 25th at 6:00pm GMT+1, and for joining us, you only have
to enter <a href="http://gitter.im/elcodi/elcodi">our gitter room</a>, say hello, and join
our discussion about Elcodi, Symfony and E-commerce.</p>

<p>One of the topics we&rsquo;ll talk about will be our roadmap. We&rsquo;ve configured it just
by thinking what features would be nice to have in the <del>future</del> present, but
Elcodi is a community-first project, so we would love to bring you some voice,
at least to help us deciding about what features we should put our effort the
next months.</p>

<blockquote><p>Of course, your voice is the most wanted voice in Elcodi. Make sure you really
say what you think, so we can improve day by day.</p></blockquote>

<p>For that, from today until the start of the meeting, you will be able to join
our room and show us your proposals. This wednesday we will vote each one, and
the most voted will be part of our <code>v1.3</code> roadmap, creating a group of
volunteers for that development.</p>

<h3>Propose a feature</h3>

<ul>
<li>Enter <a href="http://gitter.im/elcodi/elcodi">our gitter room</a></li>
<li>Say Hello! :)</li>
<li>Make a proposal</li>
</ul>


<h3>Vote the features</h3>

<ul>
<li>Enter <a href="http://gitter.im/elcodi/elcodi">our gitter room</a> next November 25th at
6:00pm GMT+1</li>
<li>Say hello! :)</li>
<li>Vote your more exciting features (before starting the meetup, you will have
the link for voting)</li>
<li>Join the development!</li>
<li>Enjoy as much as possible ;)</li>
</ul>


<p>We really look forward to see you all there!
By sharing this post you will really help us creating this community :)</p>
]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[Elcodi online meetup]]></title>
    <link href="http://elcodi-blog.github.io/blog/2015/11/20/elcodi-online-meetup/"/>
    <updated>2015-11-20T21:50:00+01:00</updated>
    <id>http://elcodi-blog.github.io/blog/2015/11/20/elcodi-online-meetup</id>
    <content type="html"><![CDATA[<p><a href="http://elcodi.io">Elcodi</a> is growing so fast.</p>

<blockquote><p>Elcodi is an E-commerce platform based on Symfony components. Is composed by
some PHP Components, by some Symfony Bundles and by a Full-stack project based
on the Symfony Framework. A all-in-one E-commerce solution, splitted in
several isolated parts.</p></blockquote>

<p>We started this project two and a half years ago, and our community is getting
bigger day after day. That&rsquo;s great because the project grows as well as long as
more people start using it (more needs, more ideas, more contributions, more
fun).</p>

<p>We will start doing monthly meetings online in our
<a href="http://gitter.im/elcodi/elcodi">Gitter channel</a>. Right now, some people is
daily contributing to Elcodi and having some nice and constructive talks, but we
want to make it even bigger.</p>

<p>Our first monthly meeting will be next November 25th at 6:00pm GMT+1.
This meeting will be hosted by the core team of the project,
<a href="https://github.com/mmoreram">Marc Morera</a> and
<a href="https://github.com/EmanueleMinotto">Emanuele Minotto</a>.</p>

<h2>Agenda</h2>

<p>This meeting will be focused on creating some working groups for the next weeks.
Depending on the people attending at the meeting, we will create more or less
groups, focused on some parts of the application.</p>

<p>These are the points we will talk about.</p>

<ul>
<li>Tasks for next version <code>v1.1</code>.</li>
<li>Documentation update and revision.</li>
<li>Test coverage for <code>v1.1</code>.</li>
<li>Community action. How to make as many people as possible involved.</li>
</ul>


<h2>Attendees</h2>

<p>Maybe you&rsquo;re asking yourself if this meeting is for you.</p>

<p>Well, it depends on your interests. If your job is all about E-commerce, even if
your Symfony skills are no so good, then you should join us. You will have the
opportunity to share some time with really skilled people and to know the way we
have created this project.</p>

<p>If your interest is open source, join us as well. Elcodi is a young project,
focused on finding the right equilibrium between pragmatism and clean
architecture. We use Event-Driven Architecture and annotations at the same time.
Do you want to know why? What are our thoughts? Ask us :)</p>

<p>In other words, if you want to have a nice time with some really good people,
then you definitely should join us and say a big Hello!</p>

<p>Remember, next November 25th at&hellip;</p>

<ul>
<li>Mexico City, La Havana &ndash; 11:00am</li>
<li>London &ndash; 05:00pm</li>
<li>Barcelona, Paris, Warsaw &ndash; 06:00pm</li>
<li>Moscow &ndash; 08:00pm</li>
</ul>


<p>Looking forward to see you all there!</p>
]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[Meet Deliberry]]></title>
    <link href="http://elcodi-blog.github.io/blog/2015/10/19/meet-deliberry/"/>
    <updated>2015-10-19T17:53:22+02:00</updated>
    <id>http://elcodi-blog.github.io/blog/2015/10/19/meet-deliberry</id>
    <content type="html"><![CDATA[<p>As an open source project, whenever a project touches success using our
technology, our pride feelings are indescribable. Each project based on Elcodi
means a different and unique story for us. Each one as much important as the
best.</p>

<p>But in this case, we want to talk about one of our first projects using Elcodi
as the main technology. And we want to do that because we really love this
company, and the way they want to really change the world. Like we want.</p>

<p>The name of the project is <a href="http://deliberry.com">Deliberry</a>, and they are
placed in Barcelona.</p>

<p><img src="http://elcodi.io/img/showcase/deliberry.png" alt="Deliberry" /></p>

<p>They deliver your supermarket purchases in less than one hour. This is great,
right? They used Elcodi components as the main technology, and our Bamboo
project as the basis for their front engine and their admin site.</p>

<p>They started using Elcodi some months ago, when we were working on version
<code>v0.5.0</code>. These days, Elcodi was very unstable, so day after day, we introduced
new changes, affecting strongly the BC standard. Even with that scenario,
Deliberry has been always our first tester for new versions, working side by
side with us, and reporting us as many issues as possible.</p>

<p>And believe us&hellip; For a new open source project&hellip; this is the best gift we&rsquo;ve
had.</p>

<h2>Changing the world with us</h2>

<p>One of the biggest things that makes this project really awesome, is that they
are really changing the world.</p>

<p>We are very used of thinking that, for a company than simply delivers food,
changing the world means delivering it faster and better. Of course, this is
great, but your are only changing part of the world, and probably, the part than
less need a change.</p>

<p>Deliberry works side by side with an organization name
<a href="http://www.caritas.es/">Cáritas</a>. This organization helps people suffering of
social exclusion (yes, in Spain we have a lot of this, sadly). People without
many resources, that cannot enjoy whether the purchase is fast or not: they
cannot even buy anything.</p>

<p>Deliberry help this organization by hiring people from this organization for
buying people&rsquo;s food, or delivering it. And everything, in less than one hour.</p>

<p>Isn&rsquo;t it fantastic?</p>

<p><a href="http://www.youtube.com/watch?v=6sXPaFB93is" title="Deliberry TV1"><img src="http://img.youtube.com/vi/6sXPaFB93is/0.jpg" alt="Deliberry TV1" /></a></p>

<p>Deliberry is our hero. Thanks for being part of the Elcodi history, and keep
changing the world, we will try to do the same :)</p>

<h2>Try Deliberry</h2>

<p>At the moment, Deliberry is only working on Barcelona, but if you are living
here, we encourage you to try it. And even better, we want to give you a nice
discount for your next purchase.</p>

<p>Use the discount code <strong><em>ELCODI</em></strong>, and with a minimum purchase of 40€ you will
recieve 10€ of discount. And if is your first time, the delivery fees will be
free!</p>

<p>Hurry up! You can use this discount during this year :)</p>

<h2>Change the world too</h2>

<p>We are looking for projects that want to change the world, somehow, somewhere.
If you have in mind one of them, consider the usage of Elcodi. Our biggest
effort goes to providing happiness and joy between E-commerce developers,
mastering amazing projects full of creativity and innovation.</p>

<p>Only this scenario turns on the best projects ever, and only the best projects
ever can change this world.</p>

<p>So&hellip; we are looking for you.<br/>
<a href="http://elcodi.io">Join us!</a></p>
]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[Install Elcodi]]></title>
    <link href="http://elcodi-blog.github.io/blog/2015/07/07/install-elcodi/"/>
    <updated>2015-07-07T12:59:39+02:00</updated>
    <id>http://elcodi-blog.github.io/blog/2015/07/07/install-elcodi</id>
    <content type="html"><![CDATA[<p>In order to decrease the time of installation of Elcodi, and with our new Beta
release</p>

<p><a href="https://github.com/elcodi/bamboo/blob/master/CHANGELOG-1.0.md#v100-beta3-10-07-2015">Bamboo v1.0.0-beta3</a><br/>
<a href="https://github.com/elcodi/elcodi/blob/master/CHANGELOG-1.0.md#v100-beta3-10-07-2015">Elcodi v1.0.0-beta3</a></p>

<p>we&rsquo;ve been working on how fast you can create a new shop in your localhost and
start tuning it. It is important right?</p>

<h2>New elcodi:install command</h2>

<p>Elcodi is Symfony based. This means that to make it work you need to execute
some commands in order to do some common actions (create database, update
schema, populate fixtures&hellip;)</p>

<p>To improve this step, we have created a new console command in order to decrease
this installation time and the number of steps required to play with your
localhost.</p>

<p>4 steps to rule them all, and less than 3 minutes to start with Elcodi.</p>

<figure class='code'><figcaption><span></span></figcaption><div class="highlight"><table><tr><td class="gutter"><pre class="line-numbers"><span class='line-number'>1</span>
<span class='line-number'>2</span>
<span class='line-number'>3</span>
<span class='line-number'>4</span>
</pre></td><td class='code'><pre><code class='bash'><span class='line'><span class="nv">$ </span>curl -s http://getcomposer.org/installer | php
</span><span class='line'><span class="nv">$ </span>php composer.phar create-project elcodi/bamboo bamboo -sdev
</span><span class='line'><span class="nv">$ </span><span class="nb">cd </span>bamboo/
</span><span class='line'><span class="nv">$ </span>php app/console elcodi:install
</span></code></pre></td></tr></table></div></figure>


<p>As soon as Bamboo is installed, you can create a temporary server by using the
PHP built-in server</p>

<figure class='code'><figcaption><span></span></figcaption><div class="highlight"><table><tr><td class="gutter"><pre class="line-numbers"><span class='line-number'>1</span>
</pre></td><td class='code'><pre><code class='bash'><span class='line'><span class="nv">$ </span>php app/console server:run
</span></code></pre></td></tr></table></div></figure>


<p>And check your Bamboo installation in your browser by accessing to
<code>http://localhost:8000</code>.</p>

<h2>GD instead of ImageMagick</h2>

<p>Because we have implemented some needs using adapters, we have implemented a new
image resize adapter based on the PHP GD engine. The good thing is that GD is
already installed in all standard PHP versions, so you don&rsquo;t really need to
install any extra library.</p>

<p>This new adapter has been proposed and accepted as the default one, and of
course, ImageMagick adapter can be still used by changing the configuration
value.</p>

<figure class='code'><figcaption><span></span></figcaption><div class="highlight"><table><tr><td class="gutter"><pre class="line-numbers"><span class='line-number'>1</span>
<span class='line-number'>2</span>
<span class='line-number'>3</span>
<span class='line-number'>4</span>
</pre></td><td class='code'><pre><code class='yaml'><span class='line'><span class="l-Scalar-Plain">elcodi_media</span><span class="p-Indicator">:</span>
</span><span class='line'>    <span class="l-Scalar-Plain">images</span><span class="p-Indicator">:</span>
</span><span class='line'>        <span class="l-Scalar-Plain">resize</span><span class="p-Indicator">:</span>
</span><span class='line'>            <span class="l-Scalar-Plain">adapter</span><span class="p-Indicator">:</span> <span class="l-Scalar-Plain">elcodi.media_resize.imagemagick</span>
</span></code></pre></td></tr></table></div></figure>


<h2>Location repository</h2>

<p>In Elcodi you can populate new countries. With this new installation command,
and by using <code>--country</code> option, you can add already generated countries in
seconds. You can see available pregenerated countries in our
<a href="https://github.com/elcodi/LocationDumps">LocationDumps</a> repository. We will
generate all countries over time.</p>

<blockquote><p>If you want to use the demo application, make sure you install Spain. All
already built addresses are from Spain. Otherwise, feel free to build your
Location database as you need.</p></blockquote>

<p>Imagine you want to install France and Italy. Well, you should do that</p>

<figure class='code'><figcaption><span></span></figcaption><div class="highlight"><table><tr><td class="gutter"><pre class="line-numbers"><span class='line-number'>1</span>
</pre></td><td class='code'><pre><code class='bash'><span class='line'><span class="nv">$ </span>php app/console elcodi:install --country<span class="o">=</span>FR --country<span class="o">=</span>IT
</span></code></pre></td></tr></table></div></figure>

]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[Elcodi beta is here]]></title>
    <link href="http://elcodi-blog.github.io/blog/2015/06/18/elcodi-beta-is-here/"/>
    <updated>2015-06-18T13:42:16+02:00</updated>
    <id>http://elcodi-blog.github.io/blog/2015/06/18/elcodi-beta-is-here</id>
    <content type="html"><![CDATA[<p>&hellip; and we did it.</p>

<p>It is something really amazing. We&rsquo;ve finally reached our first Beta stage.
After more than 1 year of hard and non-stop work, we have tagged our first beta
version in order to provide some stability to all Elcodi installations.</p>

<h2>What means Beta</h2>

<p>If you read some literature about software versions, you&rsquo;ll find that there is
always a set of pre-defined steps based on the stability of the project</p>

<ul>
<li>v1.0.0-alpha1: Hey developer! We&rsquo;re building it but we&rsquo;re not ready to be used
in production. Possible big BC breaks, incremental set of features and less
communication. Careful!</li>
<li>v1.0.0-beta1: Hey developer! Well, we think that we&rsquo;re done. We think that
we&rsquo;re done with features so we aim to stabilize the version. Testing and
documentation is part of the development here. C&#8217;mon!</li>
<li>v1.0.0-RC1: Hey developer! Tested enough, so&hellip; how about make this package
stable? Lets purpose a set of BC promises and let&rsquo;s make possible the usage of
<code>^1.0</code> in composer.</li>
<li>v1.0.0: Hey everyone! We&rsquo;re here! This package is stable. We think that we&rsquo;ve
no many issues here, so don&rsquo;t hesitate to using us in your projects.</li>
</ul>


<p>Of course, some people or projects will understand these steps in a different
way, but in Elcodi, this is the idea.</p>

<h2>Communication</h2>

<p>For the last months, we have been focused on developing.</p>

<ul>
<li>elcodi/elcodi

<ul>
<li>1.616 commits</li>
<li>239 Issues closed</li>
<li>586 PR accepted</li>
<li>21 Contributors</li>
</ul>
</li>
<li>elcodi/bamboo

<ul>
<li>1.763 commits</li>
<li>49 Issues closed</li>
<li>450 PR accepted</li>
<li>21 Contributors</li>
</ul>
</li>
</ul>


<p>Of course, developing have been our priority and we&rsquo;ve lost the opportunity of
showing the world our great work. Our communication has been poor and
insufficient because of our lack of time. And we know that this aspect of the
project need to change.</p>

<p>Since today, we&rsquo;ll return with our &ldquo;A week of Elcodi&rdquo;. Each week we will
document all our work. Each project using Elcodi will have a lot of feedback.
Each change affecting the BC compatibility will be announced in a properly way
and since today, we will take care about all projects by creating and promoting
our own community events and User Groups around the world.</p>

<p>Remember all the core team is in <a href="https://gitter.im/elcodi/elcodi">Gitter</a> so if
you have doubts and you want to talk about any aspect of the project, don&rsquo;t
hesitate to talk with us :)</p>

<p>Follow us on <a href="https://twitter.com/elcodi_dev">Twitter</a> to join us!</p>

<h2>Reaching RC</h2>

<p>We&rsquo;re done with features. We have developed a nice Plugin infrastructure that
will be documented as soon as possible, in order to externalize all extra
implementations. Our maximum priority right now is to finish what we begin
one year ago.</p>

<p>The project is pretty stable, being used in some projects in production, selling
and working properly. For example <a href="http://deliberry.com">deliberry.com</a>, a
company based in Barcelona that is actually growing day by day, based in Elcodi.</p>

<p>We&rsquo;re proud!</p>

<blockquote><p>We&rsquo;ll have soon a great directory with projects based on Elcodi, so if your
company is Elcodi based, please, show us your case :)</p></blockquote>

<p>So, for the next 2 months, we will support all projects based on Elcodi, with
a big testing layer with more Unit, Functional, Behavioral and Response testing.</p>

<p>We will add tons of documentation showing how to do every single thing inside
the Elcodi world and finally, as soon Elcodi is stable enough, then we will
tag the first RC version.</p>

<h2>Test us!</h2>

<p>We are Open Source, and supporting us will never mean paying us. Elcodi is free
because is born from and for the community, so the best way to promote Elcodi is
talking about it.</p>

<p>Elcodi is not only E-commerce and Symfony, is about developing, sharing,
enjoying and improving. Each member of the community is important and we will
demonstrate this not only with words but with a strong layer of support.</p>

<p>As soon as the community will grow, we will lead the creation of user groups
around the world. We will show how we work and what using Elcodi is not only an
experience but a way of understanding the E-commerce development.</p>

<p><a href="http://elcodi.io/docs/quick-start/">Test us now</a> and share your thoughts, your
non-valuable feedback, or <a href="https://gitter.im/elcodi/elcodi">just say hello</a> :)</p>
]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[Translating Elcodi]]></title>
    <link href="http://elcodi-blog.github.io/blog/2015/05/12/translating-elcodi/"/>
    <updated>2015-05-12T11:01:20+02:00</updated>
    <id>http://elcodi-blog.github.io/blog/2015/05/12/translating-elcodi</id>
    <content type="html"><![CDATA[<p>Hi everyone.</p>

<p>This is a call to the multi language fairy. Our project is still learning some
new and nice languages. Bamboo talks English, Spanish, Catalan and some French,
but we want to be a project for everyone in this world, no matter where you
live, no matter what you talk.</p>

<p>We are looking for some contributors to maintain some other interesting
translations. Indeed, all of them!</p>

<ul>
<li>Euskal</li>
<li>Galego</li>
<li>Deutsch</li>
<li>Italiano</li>
<li>Português</li>
<li>Nederlands</li>
<li>&hellip;</li>
</ul>


<p>We are looking for smaller translations, for those shops that want to provide
specific and local languages.</p>

<ul>
<li>Irish</li>
<li>Andalúz</li>
<li>Sardu</li>
<li>Esperanto</li>
<li>&hellip;</li>
</ul>


<p>Finally we are looking for some popular and fictitious languages. We want to be
for everyone, remember?</p>

<ul>
<li>Klingon</li>
<li>Elvish</li>
<li>Dwarf language</li>
<li>Lorem Ipsum</li>
<li>Random language</li>
<li>&hellip;</li>
</ul>


<p>If you have any interest in translate the application here, please tell us
something nice <a href="https://github.com/elcodi/bamboo/issues/450">here</a> or keep in
touch with us at <a href="http://gitter.im/elcodi/elcodi">gitter</a>.</p>

<p>Enjoy your week :)</p>
]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[Introducing the Directors in Symfony]]></title>
    <link href="http://elcodi-blog.github.io/blog/2015/04/20/introducing-the-directors-in-symfony/"/>
    <updated>2015-04-20T12:36:03+02:00</updated>
    <id>http://elcodi-blog.github.io/blog/2015/04/20/introducing-the-directors-in-symfony</id>
    <content type="html"><![CDATA[<p>Have you ever worked with Entity Managers, Repositories or Factories in Symfony?
Yes, for sure you&rsquo;ve done that. Indeed, if you work with entities in your
project, these type of objects will be your daily, so we want to introduce you a
new concept, born in <a href="http://github.com/elcodi/elcodi">Elcodi project</a> and
created in order to simplify the management of an entity inside a service,
fixture or functional test.</p>

<p>Please, welcome the Director class.</p>

<h3>Director</h3>

<p>Imagine you have a service called <code>CartWrapper</code>. This service is meant to be a
wrapper of a cart, and its behavior is that easy.</p>

<ul>
<li>If you require an existing user&rsquo;s cart, retrieve it from database and return
it</li>
<li>Otherwise, create a new Cart, save it and return it.</li>
</ul>


<p>Let&rsquo;s see a small implementation of such service.</p>

<figure class='code'><figcaption><span></span></figcaption><div class="highlight"><table><tr><td class="gutter"><pre class="line-numbers"><span class='line-number'>1</span>
<span class='line-number'>2</span>
<span class='line-number'>3</span>
<span class='line-number'>4</span>
<span class='line-number'>5</span>
<span class='line-number'>6</span>
<span class='line-number'>7</span>
<span class='line-number'>8</span>
<span class='line-number'>9</span>
<span class='line-number'>10</span>
<span class='line-number'>11</span>
<span class='line-number'>12</span>
<span class='line-number'>13</span>
<span class='line-number'>14</span>
<span class='line-number'>15</span>
<span class='line-number'>16</span>
<span class='line-number'>17</span>
<span class='line-number'>18</span>
<span class='line-number'>19</span>
<span class='line-number'>20</span>
<span class='line-number'>21</span>
<span class='line-number'>22</span>
<span class='line-number'>23</span>
<span class='line-number'>24</span>
<span class='line-number'>25</span>
<span class='line-number'>26</span>
<span class='line-number'>27</span>
<span class='line-number'>28</span>
<span class='line-number'>29</span>
<span class='line-number'>30</span>
<span class='line-number'>31</span>
<span class='line-number'>32</span>
<span class='line-number'>33</span>
<span class='line-number'>34</span>
<span class='line-number'>35</span>
<span class='line-number'>36</span>
<span class='line-number'>37</span>
<span class='line-number'>38</span>
<span class='line-number'>39</span>
<span class='line-number'>40</span>
<span class='line-number'>41</span>
<span class='line-number'>42</span>
<span class='line-number'>43</span>
<span class='line-number'>44</span>
<span class='line-number'>45</span>
<span class='line-number'>46</span>
<span class='line-number'>47</span>
<span class='line-number'>48</span>
<span class='line-number'>49</span>
<span class='line-number'>50</span>
<span class='line-number'>51</span>
<span class='line-number'>52</span>
<span class='line-number'>53</span>
<span class='line-number'>54</span>
<span class='line-number'>55</span>
<span class='line-number'>56</span>
<span class='line-number'>57</span>
<span class='line-number'>58</span>
<span class='line-number'>59</span>
<span class='line-number'>60</span>
<span class='line-number'>61</span>
<span class='line-number'>62</span>
<span class='line-number'>63</span>
<span class='line-number'>64</span>
<span class='line-number'>65</span>
<span class='line-number'>66</span>
<span class='line-number'>67</span>
<span class='line-number'>68</span>
<span class='line-number'>69</span>
<span class='line-number'>70</span>
<span class='line-number'>71</span>
<span class='line-number'>72</span>
<span class='line-number'>73</span>
<span class='line-number'>74</span>
<span class='line-number'>75</span>
<span class='line-number'>76</span>
<span class='line-number'>77</span>
<span class='line-number'>78</span>
<span class='line-number'>79</span>
</pre></td><td class='code'><pre><code class='php'><span class='line'><span class="sd">/**</span>
</span><span class='line'><span class="sd"> * CartWrapper</span>
</span><span class='line'><span class="sd"> */</span>
</span><span class='line'><span class="k">class</span> <span class="nc">cartWrapper</span>
</span><span class='line'><span class="p">{</span>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * @var EntityManager</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * Cart entity manager</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">protected</span> <span class="nv">$entityManager</span><span class="p">;</span>
</span><span class='line'>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * @var CartFactory</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * Cart factory</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">protected</span> <span class="nv">$cartFactory</span><span class="p">;</span>
</span><span class='line'>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * @var CartRepository</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * Cart repository</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">protected</span> <span class="nv">$cartRepository</span><span class="p">;</span>
</span><span class='line'>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * Construct</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @param EntityManager  $entityManager  Entity manager</span>
</span><span class='line'><span class="sd">     * @param CartFactory    $cartFactory    Cart factory</span>
</span><span class='line'><span class="sd">     * @param CartRepository $cartRepository Cart repository</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">public</span> <span class="k">function</span> <span class="nf">__construct</span><span class="p">(</span>
</span><span class='line'>        <span class="nx">EntityManager</span> <span class="nv">$entityManager</span><span class="p">,</span>
</span><span class='line'>        <span class="nx">CartFactory</span> <span class="nv">$cartFactory</span><span class="p">,</span>
</span><span class='line'>        <span class="nx">CartRepository</span> <span class="nv">$cartRepository</span>
</span><span class='line'>    <span class="p">)</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="nv">$this</span><span class="o">-&gt;</span><span class="na">entityManager</span> <span class="o">=</span> <span class="nv">$entityManager</span><span class="p">;</span>
</span><span class='line'>        <span class="nv">$this</span><span class="o">-&gt;</span><span class="na">cartFactory</span> <span class="o">=</span> <span class="nv">$cartFactory</span><span class="p">;</span>
</span><span class='line'>        <span class="nv">$this</span><span class="o">-&gt;</span><span class="na">cartRepository</span> <span class="o">=</span> <span class="nv">$cartRepository</span><span class="p">;</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * Load cart</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @param UserInterface $user User</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @return CartInterface</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">public</span> <span class="k">function</span> <span class="nf">loadCart</span><span class="p">(</span><span class="nv">$user</span><span class="p">)</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="nv">$userCart</span> <span class="o">=</span> <span class="nv">$this</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">cartRepository</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">findOneBy</span><span class="p">([</span>
</span><span class='line'>                <span class="s1">&#39;user&#39;</span> <span class="o">=&gt;</span> <span class="nv">$user</span>
</span><span class='line'>            <span class="p">]);</span>
</span><span class='line'>
</span><span class='line'>        <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="p">(</span><span class="nv">$userCart</span> <span class="nx">instanceof</span> <span class="nx">CartInterface</span><span class="p">))</span> <span class="p">{</span>
</span><span class='line'>
</span><span class='line'>            <span class="nv">$newCart</span> <span class="o">=</span> <span class="nv">$this</span>
</span><span class='line'>                <span class="o">-&gt;</span><span class="na">cartFactory</span>
</span><span class='line'>                <span class="o">-&gt;</span><span class="na">create</span><span class="p">(</span><span class="nv">$user</span><span class="p">);</span>
</span><span class='line'>
</span><span class='line'>            <span class="nv">$this</span>
</span><span class='line'>                <span class="o">-&gt;</span><span class="na">entityManager</span>
</span><span class='line'>                <span class="o">-&gt;</span><span class="na">persist</span><span class="p">(</span><span class="nv">$newCart</span><span class="p">);</span>
</span><span class='line'>
</span><span class='line'>            <span class="nv">$this</span>
</span><span class='line'>                <span class="o">-&gt;</span><span class="na">entityManager</span>
</span><span class='line'>                <span class="o">-&gt;</span><span class="na">flush</span><span class="p">(</span><span class="nv">$newCart</span><span class="p">);</span>
</span><span class='line'>
</span><span class='line'>            <span class="nv">$userCart</span> <span class="o">=</span> <span class="nv">$newCart</span><span class="p">;</span>
</span><span class='line'>        <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>        <span class="k">return</span> <span class="nv">$userCart</span><span class="p">;</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'><span class="p">}</span>
</span></code></pre></td></tr></table></div></figure>


<p>As you can see, this services needs 3 dependencies, and would be difficult to
reduce this number in order to reduce the complexity of the class. This service
is intended to do one single thing.</p>

<p>What is the strategy here? Do you know what the <em>Facade pattern</em> is, right?
Well, the way for solving this amount of classes is creating a new facade called
Director, intended to provide a small set of usable methods simplifying the
management of the entities.</p>

<p>Let&rsquo;s see the implementation of this class. You can find the real implementation
in <a href="https://github.com/elcodi/elcodi">elcodi/core</a>.</p>

<figure class='code'><figcaption><span></span></figcaption><div class="highlight"><table><tr><td class="gutter"><pre class="line-numbers"><span class='line-number'>1</span>
<span class='line-number'>2</span>
<span class='line-number'>3</span>
<span class='line-number'>4</span>
<span class='line-number'>5</span>
<span class='line-number'>6</span>
<span class='line-number'>7</span>
<span class='line-number'>8</span>
<span class='line-number'>9</span>
<span class='line-number'>10</span>
<span class='line-number'>11</span>
<span class='line-number'>12</span>
<span class='line-number'>13</span>
<span class='line-number'>14</span>
<span class='line-number'>15</span>
<span class='line-number'>16</span>
<span class='line-number'>17</span>
<span class='line-number'>18</span>
<span class='line-number'>19</span>
<span class='line-number'>20</span>
<span class='line-number'>21</span>
<span class='line-number'>22</span>
<span class='line-number'>23</span>
<span class='line-number'>24</span>
<span class='line-number'>25</span>
<span class='line-number'>26</span>
<span class='line-number'>27</span>
<span class='line-number'>28</span>
<span class='line-number'>29</span>
<span class='line-number'>30</span>
<span class='line-number'>31</span>
<span class='line-number'>32</span>
<span class='line-number'>33</span>
<span class='line-number'>34</span>
<span class='line-number'>35</span>
<span class='line-number'>36</span>
<span class='line-number'>37</span>
<span class='line-number'>38</span>
<span class='line-number'>39</span>
<span class='line-number'>40</span>
<span class='line-number'>41</span>
<span class='line-number'>42</span>
<span class='line-number'>43</span>
<span class='line-number'>44</span>
<span class='line-number'>45</span>
<span class='line-number'>46</span>
<span class='line-number'>47</span>
<span class='line-number'>48</span>
<span class='line-number'>49</span>
<span class='line-number'>50</span>
<span class='line-number'>51</span>
<span class='line-number'>52</span>
<span class='line-number'>53</span>
<span class='line-number'>54</span>
<span class='line-number'>55</span>
<span class='line-number'>56</span>
<span class='line-number'>57</span>
<span class='line-number'>58</span>
<span class='line-number'>59</span>
<span class='line-number'>60</span>
<span class='line-number'>61</span>
<span class='line-number'>62</span>
<span class='line-number'>63</span>
<span class='line-number'>64</span>
<span class='line-number'>65</span>
<span class='line-number'>66</span>
<span class='line-number'>67</span>
<span class='line-number'>68</span>
<span class='line-number'>69</span>
<span class='line-number'>70</span>
<span class='line-number'>71</span>
<span class='line-number'>72</span>
<span class='line-number'>73</span>
<span class='line-number'>74</span>
<span class='line-number'>75</span>
<span class='line-number'>76</span>
<span class='line-number'>77</span>
<span class='line-number'>78</span>
<span class='line-number'>79</span>
<span class='line-number'>80</span>
<span class='line-number'>81</span>
<span class='line-number'>82</span>
<span class='line-number'>83</span>
<span class='line-number'>84</span>
<span class='line-number'>85</span>
<span class='line-number'>86</span>
<span class='line-number'>87</span>
<span class='line-number'>88</span>
<span class='line-number'>89</span>
<span class='line-number'>90</span>
<span class='line-number'>91</span>
<span class='line-number'>92</span>
<span class='line-number'>93</span>
<span class='line-number'>94</span>
<span class='line-number'>95</span>
<span class='line-number'>96</span>
<span class='line-number'>97</span>
<span class='line-number'>98</span>
<span class='line-number'>99</span>
<span class='line-number'>100</span>
<span class='line-number'>101</span>
<span class='line-number'>102</span>
<span class='line-number'>103</span>
<span class='line-number'>104</span>
<span class='line-number'>105</span>
<span class='line-number'>106</span>
<span class='line-number'>107</span>
<span class='line-number'>108</span>
<span class='line-number'>109</span>
<span class='line-number'>110</span>
<span class='line-number'>111</span>
<span class='line-number'>112</span>
<span class='line-number'>113</span>
<span class='line-number'>114</span>
<span class='line-number'>115</span>
<span class='line-number'>116</span>
<span class='line-number'>117</span>
<span class='line-number'>118</span>
<span class='line-number'>119</span>
<span class='line-number'>120</span>
<span class='line-number'>121</span>
<span class='line-number'>122</span>
<span class='line-number'>123</span>
<span class='line-number'>124</span>
<span class='line-number'>125</span>
<span class='line-number'>126</span>
<span class='line-number'>127</span>
<span class='line-number'>128</span>
<span class='line-number'>129</span>
<span class='line-number'>130</span>
<span class='line-number'>131</span>
<span class='line-number'>132</span>
<span class='line-number'>133</span>
<span class='line-number'>134</span>
<span class='line-number'>135</span>
<span class='line-number'>136</span>
<span class='line-number'>137</span>
<span class='line-number'>138</span>
<span class='line-number'>139</span>
<span class='line-number'>140</span>
<span class='line-number'>141</span>
<span class='line-number'>142</span>
<span class='line-number'>143</span>
<span class='line-number'>144</span>
<span class='line-number'>145</span>
<span class='line-number'>146</span>
<span class='line-number'>147</span>
<span class='line-number'>148</span>
<span class='line-number'>149</span>
<span class='line-number'>150</span>
<span class='line-number'>151</span>
<span class='line-number'>152</span>
<span class='line-number'>153</span>
<span class='line-number'>154</span>
<span class='line-number'>155</span>
<span class='line-number'>156</span>
<span class='line-number'>157</span>
<span class='line-number'>158</span>
<span class='line-number'>159</span>
<span class='line-number'>160</span>
<span class='line-number'>161</span>
<span class='line-number'>162</span>
<span class='line-number'>163</span>
<span class='line-number'>164</span>
<span class='line-number'>165</span>
<span class='line-number'>166</span>
<span class='line-number'>167</span>
<span class='line-number'>168</span>
<span class='line-number'>169</span>
<span class='line-number'>170</span>
<span class='line-number'>171</span>
<span class='line-number'>172</span>
<span class='line-number'>173</span>
<span class='line-number'>174</span>
<span class='line-number'>175</span>
<span class='line-number'>176</span>
<span class='line-number'>177</span>
<span class='line-number'>178</span>
<span class='line-number'>179</span>
<span class='line-number'>180</span>
<span class='line-number'>181</span>
<span class='line-number'>182</span>
<span class='line-number'>183</span>
<span class='line-number'>184</span>
<span class='line-number'>185</span>
<span class='line-number'>186</span>
<span class='line-number'>187</span>
<span class='line-number'>188</span>
<span class='line-number'>189</span>
<span class='line-number'>190</span>
<span class='line-number'>191</span>
<span class='line-number'>192</span>
<span class='line-number'>193</span>
<span class='line-number'>194</span>
<span class='line-number'>195</span>
<span class='line-number'>196</span>
<span class='line-number'>197</span>
<span class='line-number'>198</span>
<span class='line-number'>199</span>
<span class='line-number'>200</span>
<span class='line-number'>201</span>
<span class='line-number'>202</span>
<span class='line-number'>203</span>
<span class='line-number'>204</span>
<span class='line-number'>205</span>
<span class='line-number'>206</span>
<span class='line-number'>207</span>
<span class='line-number'>208</span>
</pre></td><td class='code'><pre><code class='php'><span class='line'><span class="k">namespace</span> <span class="nx">Elcodi\Component\Core\Services</span><span class="p">;</span>
</span><span class='line'>
</span><span class='line'><span class="k">use</span> <span class="nx">Doctrine\Common\Persistence\ObjectManager</span><span class="p">;</span>
</span><span class='line'><span class="k">use</span> <span class="nx">Doctrine\Common\Persistence\ObjectRepository</span><span class="p">;</span>
</span><span class='line'><span class="k">use</span> <span class="nx">UnexpectedValueException</span><span class="p">;</span>
</span><span class='line'>
</span><span class='line'><span class="k">use</span> <span class="nx">Elcodi\Component\Core\Factory\Abstracts\AbstractFactory</span><span class="p">;</span>
</span><span class='line'>
</span><span class='line'><span class="sd">/**</span>
</span><span class='line'><span class="sd"> * Class ObjectDirector</span>
</span><span class='line'><span class="sd"> *</span>
</span><span class='line'><span class="sd"> * This object is a facade for these different persistence-related elements</span>
</span><span class='line'><span class="sd"> *</span>
</span><span class='line'><span class="sd"> * * Object Manager</span>
</span><span class='line'><span class="sd"> * * Repository</span>
</span><span class='line'><span class="sd"> * * Factory</span>
</span><span class='line'><span class="sd"> *</span>
</span><span class='line'><span class="sd"> * Allows final user to manage in a simple way an entity or a set of entities.</span>
</span><span class='line'><span class="sd"> * Provides a reduced (but useful) set of methods.</span>
</span><span class='line'><span class="sd"> */</span>
</span><span class='line'><span class="k">class</span> <span class="nc">ObjectDirector</span>
</span><span class='line'><span class="p">{</span>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * @var ObjectManager</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * Manager</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">protected</span> <span class="nv">$manager</span><span class="p">;</span>
</span><span class='line'>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * @var ObjectRepository</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * Repository</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">protected</span> <span class="nv">$repository</span><span class="p">;</span>
</span><span class='line'>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * @var AbstractFactory</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * Factory</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">protected</span> <span class="nv">$factory</span><span class="p">;</span>
</span><span class='line'>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * Construct</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @param ObjectManager    $manager    Manager</span>
</span><span class='line'><span class="sd">     * @param ObjectRepository $repository Repository</span>
</span><span class='line'><span class="sd">     * @param AbstractFactory  $factory    Factory</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">public</span> <span class="k">function</span> <span class="nf">__construct</span><span class="p">(</span>
</span><span class='line'>        <span class="nx">ObjectManager</span> <span class="nv">$manager</span><span class="p">,</span>
</span><span class='line'>        <span class="nx">ObjectRepository</span> <span class="nv">$repository</span><span class="p">,</span>
</span><span class='line'>        <span class="nx">AbstractFactory</span> <span class="nv">$factory</span>
</span><span class='line'>    <span class="p">)</span> <span class="p">{</span>
</span><span class='line'>        <span class="nv">$this</span><span class="o">-&gt;</span><span class="na">manager</span> <span class="o">=</span> <span class="nv">$manager</span><span class="p">;</span>
</span><span class='line'>        <span class="nv">$this</span><span class="o">-&gt;</span><span class="na">repository</span> <span class="o">=</span> <span class="nv">$repository</span><span class="p">;</span>
</span><span class='line'>        <span class="nv">$this</span><span class="o">-&gt;</span><span class="na">factory</span> <span class="o">=</span> <span class="nv">$factory</span><span class="p">;</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * Finds an object by its primary key / identifier.</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @param mixed $id The identifier.</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @return object|null Fetched object</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">public</span> <span class="k">function</span> <span class="nf">find</span><span class="p">(</span><span class="nv">$id</span><span class="p">)</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="k">return</span> <span class="nv">$this</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">repository</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">find</span><span class="p">(</span><span class="nv">$id</span><span class="p">);</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * Finds all objects in the repository.</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @return array Set of fetched objects</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">public</span> <span class="k">function</span> <span class="nf">findAll</span><span class="p">()</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="k">return</span> <span class="nv">$this</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">repository</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">findAll</span><span class="p">();</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * Finds objects by a set of criteria.</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * Optionally sorting and limiting details can be passed. An implementation may throw</span>
</span><span class='line'><span class="sd">     * an UnexpectedValueException if certain values of the sorting or limiting details are</span>
</span><span class='line'><span class="sd">     * not supported.</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @param array        $criteria</span>
</span><span class='line'><span class="sd">     * @param array|null   $orderBy</span>
</span><span class='line'><span class="sd">     * @param integer|null $limit</span>
</span><span class='line'><span class="sd">     * @param integer|null $offset</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @return array Set of fetched objects</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @throws UnexpectedValueException</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">public</span> <span class="k">function</span> <span class="nf">findBy</span><span class="p">(</span>
</span><span class='line'>        <span class="k">array</span> <span class="nv">$criteria</span><span class="p">,</span>
</span><span class='line'>        <span class="k">array</span> <span class="nv">$orderBy</span> <span class="o">=</span> <span class="k">null</span><span class="p">,</span>
</span><span class='line'>        <span class="nv">$limit</span> <span class="o">=</span> <span class="k">null</span><span class="p">,</span>
</span><span class='line'>        <span class="nv">$offset</span> <span class="o">=</span> <span class="k">null</span><span class="p">)</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="k">return</span> <span class="nv">$this</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">repository</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">findBy</span><span class="p">(</span>
</span><span class='line'>                <span class="nv">$criteria</span><span class="p">,</span>
</span><span class='line'>                <span class="nv">$orderBy</span><span class="p">,</span>
</span><span class='line'>                <span class="nv">$limit</span><span class="p">,</span>
</span><span class='line'>                <span class="nv">$offset</span>
</span><span class='line'>            <span class="p">);</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * Finds a single object given a criteria.</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @param array $criteria The criteria.</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @return object|null Fetched object</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">public</span> <span class="k">function</span> <span class="nf">findOneBy</span><span class="p">(</span><span class="k">array</span> <span class="nv">$criteria</span><span class="p">)</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="k">return</span> <span class="nv">$this</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">repository</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">findOneBy</span><span class="p">(</span>
</span><span class='line'>                <span class="nv">$criteria</span>
</span><span class='line'>            <span class="p">);</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * Create a new entity instance, result of the factory creation method</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @return Object new Instance</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">public</span> <span class="k">function</span> <span class="nf">create</span><span class="p">()</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="k">return</span> <span class="nv">$this</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">factory</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">create</span><span class="p">();</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * Save the instance into database. Given data can be a single object or</span>
</span><span class='line'><span class="sd">     * an array of objects.</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * This method will persist and flush given object/array of objects</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @param object|array $data Data to save into database</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @return object|array Saved data</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">public</span> <span class="k">function</span> <span class="nf">save</span><span class="p">(</span><span class="nv">$data</span><span class="p">)</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="k">if</span> <span class="p">(</span><span class="nb">is_array</span><span class="p">(</span><span class="nv">$data</span><span class="p">))</span> <span class="p">{</span>
</span><span class='line'>            <span class="k">foreach</span> <span class="p">(</span><span class="nv">$data</span> <span class="k">as</span> <span class="nv">$entity</span><span class="p">)</span> <span class="p">{</span>
</span><span class='line'>                <span class="nv">$this</span>
</span><span class='line'>                    <span class="o">-&gt;</span><span class="na">manager</span>
</span><span class='line'>                    <span class="o">-&gt;</span><span class="na">persist</span><span class="p">(</span><span class="nv">$entity</span><span class="p">);</span>
</span><span class='line'>            <span class="p">}</span>
</span><span class='line'>        <span class="p">}</span> <span class="k">else</span> <span class="p">{</span>
</span><span class='line'>            <span class="nv">$this</span>
</span><span class='line'>                <span class="o">-&gt;</span><span class="na">manager</span>
</span><span class='line'>                <span class="o">-&gt;</span><span class="na">persist</span><span class="p">(</span><span class="nv">$data</span><span class="p">);</span>
</span><span class='line'>        <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>        <span class="nv">$this</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">manager</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">flush</span><span class="p">(</span><span class="nv">$data</span><span class="p">);</span>
</span><span class='line'>
</span><span class='line'>        <span class="k">return</span> <span class="nv">$data</span><span class="p">;</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * Remove the instance from the database. Given data can be a single object or</span>
</span><span class='line'><span class="sd">     * an array of objects.</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * This method will remove and flush given object/array of objects</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @param object|array $data Data to remove from database</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @return object|array Removed data</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">public</span> <span class="k">function</span> <span class="nf">remove</span><span class="p">(</span><span class="nv">$data</span><span class="p">)</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="k">if</span> <span class="p">(</span><span class="nb">is_array</span><span class="p">(</span><span class="nv">$data</span><span class="p">))</span> <span class="p">{</span>
</span><span class='line'>            <span class="k">foreach</span> <span class="p">(</span><span class="nv">$data</span> <span class="k">as</span> <span class="nv">$entity</span><span class="p">)</span> <span class="p">{</span>
</span><span class='line'>                <span class="nv">$this</span>
</span><span class='line'>                    <span class="o">-&gt;</span><span class="na">manager</span>
</span><span class='line'>                    <span class="o">-&gt;</span><span class="na">remove</span><span class="p">(</span><span class="nv">$entity</span><span class="p">);</span>
</span><span class='line'>            <span class="p">}</span>
</span><span class='line'>        <span class="p">}</span> <span class="k">else</span> <span class="p">{</span>
</span><span class='line'>            <span class="nv">$this</span>
</span><span class='line'>                <span class="o">-&gt;</span><span class="na">manager</span>
</span><span class='line'>                <span class="o">-&gt;</span><span class="na">remove</span><span class="p">(</span><span class="nv">$data</span><span class="p">);</span>
</span><span class='line'>        <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>        <span class="nv">$this</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">manager</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">flush</span><span class="p">(</span><span class="nv">$data</span><span class="p">);</span>
</span><span class='line'>
</span><span class='line'>        <span class="k">return</span> <span class="nv">$data</span><span class="p">;</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'><span class="p">}</span>
</span></code></pre></td></tr></table></div></figure>


<p>This implementation provides us a simple set of actions for our entities (maybe
the most used).</p>

<ul>
<li>find(&hellip;)</li>
<li>findAll()</li>
<li>findBy(&hellip;)</li>
<li>findOneBy(&hellip;)</li>
<li>create()</li>
<li>save()</li>
<li>remove()</li>
</ul>


<p>This implementation is so useful for many scenarios, but in our case what we
found is that using Directors, our tests are reduced in many ways (less lines of
code, less complexity, more effectiveness), and the fixtures are totally
improved, focusing on the most important thing: our business logic.</p>

<h3>Directors as a service</h3>

<p>To use a Director as a service you need to define your repository as a service
as well, assuming that your factory is already a service called <code>cart_factory</code>
and assuming as well that we will work with the default entity manager
<code>doctrine.orm.default_entity_manager</code> (not a good practice, but let&rsquo;s suppose it
is in this example).</p>

<p>Let&rsquo;s see how to define your repository as a service.</p>

<figure class='code'><figcaption><span></span></figcaption><div class="highlight"><table><tr><td class="gutter"><pre class="line-numbers"><span class='line-number'>1</span>
<span class='line-number'>2</span>
<span class='line-number'>3</span>
<span class='line-number'>4</span>
<span class='line-number'>5</span>
<span class='line-number'>6</span>
<span class='line-number'>7</span>
<span class='line-number'>8</span>
<span class='line-number'>9</span>
<span class='line-number'>10</span>
<span class='line-number'>11</span>
<span class='line-number'>12</span>
</pre></td><td class='code'><pre><code class='yaml'><span class='line'><span class="l-Scalar-Plain">services</span><span class="p-Indicator">:</span>
</span><span class='line'>
</span><span class='line'>    <span class="c1">#</span>
</span><span class='line'>    <span class="c1"># Doctrine Repository</span>
</span><span class='line'>    <span class="c1">#</span>
</span><span class='line'>    <span class="l-Scalar-Plain">cart_repository</span><span class="p-Indicator">:</span>
</span><span class='line'>        <span class="l-Scalar-Plain">class</span><span class="p-Indicator">:</span> <span class="l-Scalar-Plain">Doctrine\Common\Persistence\ObjectRepository</span>
</span><span class='line'>        <span class="l-Scalar-Plain">factory</span><span class="p-Indicator">:</span>
</span><span class='line'>            <span class="p-Indicator">-</span> <span class="err">@</span><span class="l-Scalar-Plain">elcodi.provider.repository</span>
</span><span class='line'>            <span class="p-Indicator">-</span> <span class="l-Scalar-Plain">getRepositoryByEntityNamespace</span>
</span><span class='line'>        <span class="l-Scalar-Plain">arguments</span><span class="p-Indicator">:</span>
</span><span class='line'>            <span class="p-Indicator">-</span> <span class="l-Scalar-Plain">My\Cart\Namespace</span>
</span></code></pre></td></tr></table></div></figure>


<p>You will find the service <code>elcodi.provider.repository</code> inside the Bundle
<code>elcodi/core-bundle</code>. This bundle is not coupled to any Elcodi functionality so
you can use it in your own projects as a set of isolated features.</p>

<p>Finally, let&rsquo;s create the Director definition by using the factory pattern.</p>

<figure class='code'><figcaption><span></span></figcaption><div class="highlight"><table><tr><td class="gutter"><pre class="line-numbers"><span class='line-number'>1</span>
<span class='line-number'>2</span>
<span class='line-number'>3</span>
<span class='line-number'>4</span>
<span class='line-number'>5</span>
<span class='line-number'>6</span>
<span class='line-number'>7</span>
<span class='line-number'>8</span>
<span class='line-number'>9</span>
<span class='line-number'>10</span>
<span class='line-number'>11</span>
</pre></td><td class='code'><pre><code class='yaml'><span class='line'><span class="l-Scalar-Plain">services</span><span class="p-Indicator">:</span>
</span><span class='line'>
</span><span class='line'>    <span class="c1">#</span>
</span><span class='line'>    <span class="c1"># Directors</span>
</span><span class='line'>    <span class="c1">#</span>
</span><span class='line'>    <span class="l-Scalar-Plain">elcodi.director.cart</span><span class="p-Indicator">:</span>
</span><span class='line'>        <span class="l-Scalar-Plain">class</span><span class="p-Indicator">:</span> <span class="l-Scalar-Plain">Elcodi\Component\Core\Services\ObjectDirector</span>
</span><span class='line'>        <span class="l-Scalar-Plain">arguments</span><span class="p-Indicator">:</span>
</span><span class='line'>            <span class="p-Indicator">-</span> <span class="err">@</span><span class="l-Scalar-Plain">doctrine.orm.default_entity_manager</span>
</span><span class='line'>            <span class="p-Indicator">-</span> <span class="err">@</span><span class="l-Scalar-Plain">cart_repository</span>
</span><span class='line'>            <span class="p-Indicator">-</span> <span class="err">@</span><span class="l-Scalar-Plain">cart_factory</span>
</span></code></pre></td></tr></table></div></figure>


<p>Take in account that each entity will have it&rsquo;s own Director instance, so this
is why we use the factory pattern here.</p>

<p>How can we use the new Director service in our first <code>CartWrapper</code>
implementation by changing and improving the services dependencies? Let&rsquo;s do
that!</p>

<figure class='code'><figcaption><span></span></figcaption><div class="highlight"><table><tr><td class="gutter"><pre class="line-numbers"><span class='line-number'>1</span>
<span class='line-number'>2</span>
<span class='line-number'>3</span>
<span class='line-number'>4</span>
<span class='line-number'>5</span>
<span class='line-number'>6</span>
<span class='line-number'>7</span>
<span class='line-number'>8</span>
<span class='line-number'>9</span>
<span class='line-number'>10</span>
<span class='line-number'>11</span>
<span class='line-number'>12</span>
<span class='line-number'>13</span>
<span class='line-number'>14</span>
<span class='line-number'>15</span>
<span class='line-number'>16</span>
<span class='line-number'>17</span>
<span class='line-number'>18</span>
<span class='line-number'>19</span>
<span class='line-number'>20</span>
<span class='line-number'>21</span>
<span class='line-number'>22</span>
<span class='line-number'>23</span>
<span class='line-number'>24</span>
<span class='line-number'>25</span>
<span class='line-number'>26</span>
<span class='line-number'>27</span>
<span class='line-number'>28</span>
<span class='line-number'>29</span>
<span class='line-number'>30</span>
<span class='line-number'>31</span>
<span class='line-number'>32</span>
<span class='line-number'>33</span>
<span class='line-number'>34</span>
<span class='line-number'>35</span>
<span class='line-number'>36</span>
<span class='line-number'>37</span>
<span class='line-number'>38</span>
<span class='line-number'>39</span>
<span class='line-number'>40</span>
<span class='line-number'>41</span>
<span class='line-number'>42</span>
<span class='line-number'>43</span>
<span class='line-number'>44</span>
<span class='line-number'>45</span>
<span class='line-number'>46</span>
<span class='line-number'>47</span>
<span class='line-number'>48</span>
<span class='line-number'>49</span>
<span class='line-number'>50</span>
<span class='line-number'>51</span>
<span class='line-number'>52</span>
<span class='line-number'>53</span>
</pre></td><td class='code'><pre><code class='php'><span class='line'><span class="sd">/**</span>
</span><span class='line'><span class="sd"> * CartWrapper</span>
</span><span class='line'><span class="sd"> */</span>
</span><span class='line'><span class="k">class</span> <span class="nc">cartWrapper</span>
</span><span class='line'><span class="p">{</span>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * @var ObjectDirector</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * Cart director</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">protected</span> <span class="nv">$cartDirector</span><span class="p">;</span>
</span><span class='line'>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * Construct</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @param ObjectDirector $cartDirector Cart Director</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">public</span> <span class="k">function</span> <span class="nf">__construct</span><span class="p">(</span><span class="nx">ObjectDirector</span> <span class="nv">$cartDirector</span><span class="p">)</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="nv">$this</span><span class="o">-&gt;</span><span class="na">cartDirector</span> <span class="o">=</span> <span class="nv">$cartDirector</span><span class="p">;</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>    <span class="sd">/**</span>
</span><span class='line'><span class="sd">     * Load cart</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @param UserInterface $user User</span>
</span><span class='line'><span class="sd">     *</span>
</span><span class='line'><span class="sd">     * @return CartInterface</span>
</span><span class='line'><span class="sd">     */</span>
</span><span class='line'>    <span class="k">public</span> <span class="k">function</span> <span class="nf">loadCart</span><span class="p">(</span><span class="nv">$user</span><span class="p">)</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="nv">$userCart</span> <span class="o">=</span> <span class="nv">$this</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">cartDirector</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">findOneBy</span><span class="p">([</span>
</span><span class='line'>                <span class="s1">&#39;user&#39;</span> <span class="o">=&gt;</span> <span class="nv">$user</span>
</span><span class='line'>            <span class="p">]);</span>
</span><span class='line'>
</span><span class='line'>        <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="p">(</span><span class="nv">$userCart</span> <span class="nx">instanceof</span> <span class="nx">CartInterface</span><span class="p">))</span> <span class="p">{</span>
</span><span class='line'>
</span><span class='line'>            <span class="nv">$newCart</span> <span class="o">=</span> <span class="nv">$this</span>
</span><span class='line'>                <span class="o">-&gt;</span><span class="na">cartDirector</span>
</span><span class='line'>                <span class="o">-&gt;</span><span class="na">create</span><span class="p">(</span><span class="nv">$user</span><span class="p">);</span>
</span><span class='line'>
</span><span class='line'>            <span class="nv">$this</span>
</span><span class='line'>                <span class="o">-&gt;</span><span class="na">cartDirector</span>
</span><span class='line'>                <span class="o">-&gt;</span><span class="na">save</span><span class="p">(</span><span class="nv">$newCart</span><span class="p">);</span>
</span><span class='line'>
</span><span class='line'>            <span class="nv">$userCart</span> <span class="o">=</span> <span class="nv">$newCart</span><span class="p">;</span>
</span><span class='line'>        <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>        <span class="k">return</span> <span class="nv">$userCart</span><span class="p">;</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'><span class="p">}</span>
</span></code></pre></td></tr></table></div></figure>


<p><a href="http://github.com/elcodi/elcodi">Elcodi</a> is fully based on the usage of
Directors. This does <strong>not</strong> mean that we must use Directors everywhere.
Sometimes you need to use only one of the wrapped objects, and in that case you
must inject them one by one, so please, before using this new object think about
it, think about the pros and the contras and be responsible about your
implementation.</p>

<p>Don&rsquo;t hesitate to comment about what do you think about this feature.</p>

<p>Have a nice day!</p>
]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[First stable release]]></title>
    <link href="http://elcodi-blog.github.io/blog/2015/04/04/first-stable-release/"/>
    <updated>2015-04-04T19:51:28+02:00</updated>
    <id>http://elcodi-blog.github.io/blog/2015/04/04/first-stable-release</id>
    <content type="html"><![CDATA[<p>Hi there everyone.</p>

<p>The Elcodi core team is glad to announce that next June 1st, we will tag the
first stable release of the project (Elcodi will be still based on Symfony, you
know how much we like Symfony and its community&hellip;)</p>

<h3>Elcodi v1.0</h3>

<ul>
<li>Until this day, we&rsquo;ll finish stabilization of all packages</li>
<li>We will work so hard to finish a documentation for all of you</li>
<li>All available features will be covered by unit, functional and behavioral
tests, using PHPUnit and Behat 3.0</li>
<li>After <code>v1.0</code> we will start working on <code>v3.0</code>. This new version will be
released next November in order to be compatible with Symfony <code>v3.*</code>. It means
as well that this new version will introduce some BC Break, of course.</li>
</ul>


<p>So, we have less than 2 months to stabilize Elcodi package, and we need your
help.</p>

<p>Some days ago, we announced the
<a href="http://blog.elcodi.io/blog/2015/03/03/elcodi-bug-hunting/">Elcodi Bug Hunting</a>,
remember? Well, initially this contest was during this past March, but we have
decided to enlarge the period of the contest until June 1st, the day of the
release.</p>

<p>Until now, we have received some help from some people. Special thanks for them.</p>

<ul>
<li><a href="https://github.com/elcodi/elcodi/pulls?q=is%3Apr+is%3Aclosed+author%3Acordoval">cordoval</a></li>
<li><a href="https://github.com/elcodi/elcodi/pulls?q=is%3Apr+is%3Aclosed+author%3Ajaviereguiluz">javiereguiluz</a></li>
<li><a href="https://github.com/elcodi/elcodi/pulls?q=is%3Apr+is%3Aclosed+author%3Ahacfi">hacfi</a></li>
<li><a href="https://github.com/elcodi/elcodi/pulls?q=is%3Apr+is%3Aclosed+author%3Amickaelandrieu">mickaelandrieu</a></li>
<li><a href="https://github.com/elcodi/elcodi/pulls?q=is%3Apr+is%3Aclosed">And many more</a></li>
</ul>


<p>But we need some extra help in order to accomplish our goal.</p>

<h3>Win the MacBookPro</h3>

<p>Easy and super-fast. Do you want to win the MacBookPro? Easy, just help us with
some fast actions and you will be able to win the
<strong>Apple Macbook Pro 2014 Retina</strong> (of course, with an Android/Ubuntu/Windows
alternative or any geeky stuff with same price)</p>

<ul>
<li>Follow us on twitter (@elcodi_dev)</li>
<li>Give <a href="http://github.com/elcodi/elcodi">Elcodi repository</a> a star</li>
<li>Give <a href="http://github.com/elcodi/bamboo">Bamboo repository</a> a star</li>
<li>Give <a href="http://github.com/elcodi/docs">Elcodi docs repository</a> a star</li>
<li>Make a funny tweet about it, for example, sharing this post or trolling us
a little bit :)</li>
</ul>


<p>After that you will have 5 points, enough to access to the MacBookPro raffle.</p>

<h3>A little bit more&hellip;</h3>

<p>Are you interested in E-commerce and do you like Symfony? Well, there are some
extra things you can do to help. You can win the battle and win the
<strong>Ipad Air</strong></p>

<ul>
<li>[Download, install and try Bamboo)[<a href="http://elcodi.io/docs/quick-start.html">http://elcodi.io/docs/quick-start.html</a>)</li>
<li>If you find any kind of issue, please open an Issue in our repository and
report it to us.</li>
<li>Oh, you know how to fix it? That&rsquo;s wonderful! Create a Pull Request and be a
collaborator of the project!</li>
<li>We are elaborating a documentation&hellip; maybe you could help us looking for some
typo issues or creating new content&hellip;</li>
<li>Have you tried Elcodi and you want to express the world how much excited you
are? Great! Do a post in your blog and explain us what did you create with
Elcodi!</li>
<li>Elcodi is an international project, so we are looking for people able to
translate Bamboo to all languages (even in Klingon and Esperanto!). Are you
proud of your language? Well, help other people of your country for using this
project :)</li>
</ul>


<p>All this actions will give you some extra points.</p>

<p>Of course, if you need help, all Elcodi Core team will gladly help you. Just
enter <a href="https://gitter.im/elcodi/elcodi">Elcodi Gitter room</a> and say hello :)</p>

<p>Have a nice day!</p>
]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[Elcodi changes its technology]]></title>
    <link href="http://elcodi-blog.github.io/blog/2015/04/01/elcodi-changes-its-technology/"/>
    <updated>2015-04-01T16:45:38+02:00</updated>
    <id>http://elcodi-blog.github.io/blog/2015/04/01/elcodi-changes-its-technology</id>
    <content type="html"><![CDATA[<p>This is an official statement from Elcodi Team.</p>

<blockquote><p>This post was an April Fools joke. Elcodi will be based on Symfony for a long
time. We love Symfony.</p></blockquote>

<p>After some nice months using Symfony in our project Elcodi, and after many
reflections on how to increase the project quality, we&rsquo;re proud to announce that
we are moving to Ruby on Rails.</p>

<p>Until version <code>v0.6.*</code> we will continue evolving our code for these people who
is nowadays using Elcodi in their projects, but after that, we will move all
our code to Ruby.</p>

<p><img src="http://planetargon.com/images/rails-love.png" alt="We love rails" /></p>

<p>If you need some information, feel free to keep in touch with us in our
<a href="https://gitter.im/elcodi/elcodi">Gitter account</a></p>
]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[Elcodi Bug Hunting]]></title>
    <link href="http://elcodi-blog.github.io/blog/2015/03/03/elcodi-bug-hunting/"/>
    <updated>2015-03-03T16:19:05+01:00</updated>
    <id>http://elcodi-blog.github.io/blog/2015/03/03/elcodi-bug-hunting</id>
    <content type="html"><![CDATA[<p>Hi everyone!</p>

<p>It&rsquo;s been a long time since our last meeting! We&rsquo;ve been very busy here in
Elcodi HQ this months, focusing on the following events. And here we are to tell
you!</p>

<h2>New members</h2>

<p>Our team has grown, and we&rsquo;ll be proud to introduce our two new members properly
to you soon. For now, welcome <a href="//twitter.com/tonipinel">@tonipinel</a> and
<a href="//twitter.com/rogergros">@rogergros</a>!</p>

<h2>It&rsquo;s beta time!</h2>

<p>These last weeks have been awesome here! After a lot of working hours, coffees
and pizzas (and some beers), we&rsquo;re proud and happy to announce we&rsquo;ve reached
<strong>beta status in Elcodi</strong> and new version: <strong>v0.5.0</strong>.</p>

<p>This is working. This is really working! Now it&rsquo;s time to test it, massively.</p>

<h2>Elcodi Bug Hunting</h2>

<p>In order to make the community participant, we&rsquo;ll arrange something really
amazing: <strong>A contest!</strong>. We have named it <em>Elcodi Bug Hunting</em> and will be
available during March 2015.</p>

<blockquote><p>Edit: This contest will be opened until June 1st, the day of our first
release. It makes sense to increase the contest interval in order to get more
changes and more competition :)</p></blockquote>

<p>Let us explain what&rsquo;s this all about!</p>

<h3>The contest</h3>

<p><img src="https://cloud.githubusercontent.com/assets/170968/6443700/f152ea5e-c0f8-11e4-9acb-63c5f817b7a8.jpg" alt="bugs-everywhere" /></p>

<p>Our goal is to find and fix as many bugs as possible during the beta period, and
to grow more as a community.</p>

<h3>The prices</h3>

<ul>
<li>Apple Macbook Pro 2014 Retina 13&#8221;</li>
<li>Apple Ipad Air 16Gb</li>
</ul>


<h3>Scoring</h3>

<ul>
<li>Earn points by participating in <em>Elcodi Bug Hunting</em>.</li>
<li>Earn 5 points or more to access the <strong>Macbook Pro</strong> raffle.</li>
<li>The more points you have, the more chances to win the raffle.</li>
<li>Get the highest score and win an <strong>Ipad Air</strong>!</li>
</ul>


<h4>The easypick</h4>

<p>Social interaction is important to us, because that&rsquo;s the way we&rsquo;re reaching and
hearing from you. And we want <strong>you</strong> to be part of this!</p>

<p>That&rsquo;s why we&rsquo;ll reward you for:</p>

<ul>
<li>Star on Github (<a href="//github.com/elcodi/elcodi">elcodi/elcodi</a>) &ndash; <em>1 point</em></li>
<li>Star on Github (<a href="//github.com/elcodi/bamboo">elcodi/bamboo</a>) &ndash; <em>1 point</em></li>
<li>Follow on Twitter (<a href="//twitter.com/elcodi_dev">@elcodi_dev</a>) &ndash; <em>1 point</em></li>
<li>Twitter mention &ndash; <em>1 point (max 2)</em></li>
</ul>


<h4>The collaborator</h4>

<p>The more eyes looking at our code, the better chance to improve! Collaboration
is vital for an OpenSource project like this, and we&rsquo;re open for suggestions and
contributions. We want Elcodi to be helpful to you.</p>

<p>Give a try and clone <a href="//github.com/elcodi/elcodi">Elcodi project</a> or
<a href="//github.com/elcodi/bamboo">our store Bamboo</a>, enter
<a href="//gitter.im/elcodi/elcodi">Elcodi at Gitter</a>, discuss with us and participate.
That&rsquo;s OpenSource at it&rsquo;s finest!</p>

<p>We will appreciate:</p>

<ul>
<li>Open Github issue &ndash; <em>2 points</em></li>
<li>Creating a Pull Request &ndash; <em>2 points</em></li>
<li>Accepted Pull Request &ndash; <em>5 points</em></li>
<li>Contributors up to present day &ndash; <em>10 points</em></li>
</ul>


<h4>The Best of the best</h4>

<p>We encourage those who work hard. That&rsquo;s why we&rsquo;ll distribute some points
discretely based on:</p>

<ul>
<li>Best 5 pull requests &ndash; <em>5 points</em></li>
<li>Best 3 tweets &ndash; <em>15, 10, 5 points</em></li>
<li>Best 3 troll-tweets &ndash; <em>15, 10, 5 points</em></li>
</ul>


<h3>The jury</h3>

<ul>
<li>Marc Morera (<a href="//twitter.com/mmoreram">@mmoreram</a>)</li>
<li>Aldo Chiecchia (<a href="//twitter.com/alch">@alch</a>)</li>
<li>Berny Cantos (<a href="//twitter.com/xphere">@xphere</a>)</li>
<li>Toni Pinel (<a href="//twitter.com/tonipinel">@tonipinel</a>)</li>
<li>Roger Gros (<a href="//twitter.com/rogergros">@rogergros</a>)</li>
</ul>


<h2>Let&rsquo;s <del>Go</del> PHP!!</h2>

<p>Feel free to try the platform, test it and find security vulnerabilities and
bugs. During this month we will improve current features and we will focus on
the quality of the code, with small refactors and more (and more) tests.</p>

<p>We will work as well with the documentation, so feel free to help us on that
task :)</p>

<p>Don&rsquo;t hesitate to get in touch with us and enjoy Elcodi! :)</p>
]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[A Week of Elcodi #5 (24/11 - 08/12)]]></title>
    <link href="http://elcodi-blog.github.io/blog/2014/12/11/a-week-of-elcodi-number-5/"/>
    <updated>2014-12-11T20:15:24+01:00</updated>
    <id>http://elcodi-blog.github.io/blog/2014/12/11/a-week-of-elcodi-number-5</id>
    <content type="html"><![CDATA[<p>Hi there! These two weeks have been full of work, with our talk in <a href="http://madrid2014.symfony.com">SymfonyCon</a> being the highlight. We&rsquo;re working on a post explaining the experience but, in short, it was amazing to present Elcodi to the people in the Symfony community. Stay tuned!</p>

<p>Meanwhile, on this side of the keyboard, we&rsquo;ve been doing some things also, such as resume the implementation of our <code>StateTransitionMachine</code>, previously known as <code>StateMachine</code>, and polishing some details.</p>

<p>Besides, we wanted to implement an entity translator completely decoupled of our entities, because we think that the most important part of an e-commerce project is the model. So we worked on it for a while and now the <a href="https://github.com/elcodi/elcodi/pull/382">Translator component</a> is born. You&rsquo;re welcome to comment and collaborate on the implementation.</p>

<p>To persist the settings for each shop, we are working on a <a href="https://github.com/elcodi/elcodi/pull/383">dynamic configuration component</a> useful for storing simple values. As usual, it comes with adapters so that any backend storage can be supported.</p>

<p>From the viewpoint of desing, we want a more agile, easy and intuitive admin experience, so we&rsquo;re checking and improving the UX of Elcodi Admin&rsquo;s interface. First adjustments include some improvements about navigation, and an early approach to the first-time experience, something that we will look in depth in the next week.</p>

<p>Also we&rsquo;re putting together our <a href="https://github.com/elcodi/elcodi/pull/378">new Page component</a> to be as generic as possible, but user-friendly too. This includes developers: we are making great efforts to provide a better DX (Developer eXperience), so feel free to drop by our <a href="https://gitter.im/elcodi/elcodi">gitter</a> and ask your own questions. We&rsquo;ll be glad to help you. ;)</p>

<p>See you next week!</p>
]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[A week of Elcodi #4 (17/11 - 24/11)]]></title>
    <link href="http://elcodi-blog.github.io/blog/2014/11/25/a-week-of-elcodi-number-4/"/>
    <updated>2014-11-25T12:39:32+01:00</updated>
    <id>http://elcodi-blog.github.io/blog/2014/11/25/a-week-of-elcodi-number-4</id>
    <content type="html"><![CDATA[<p>Last few days were kind of crazy at Elcodi, with @alch <a href="http://madrid2014.symfony.com/speakers#session-1399">leaving the slides ready for our speak at the #SymfonyCon</a>, @mmoreram <a href="http://mmoreram.com/blog/2014/11/25/symfony-walk-ends">walking the #SymfonyWalk</a> and @xphere <a href="https://github.com/elcodi/elcodi">annoying in our GitHub repository</a> and <a href="http://blog.elcodi.io/blog/categories/one-section-one-component">writing about Symfony Components</a>.</p>

<p>But this madness is great, trust me! We&rsquo;ll reach a milestone in our path with the forthcoming #SymfonyCon, and we&rsquo;re proud and happy to have the opportunity to be there, to explain our point of view, the approach we&rsquo;re giving to Elcodi.</p>

<p>Remember, you can keep in touch with us in our <a href="https://gitter.im/elcodi/elcodi">gitter chat</a> and our <a href="https://twitter.com/elcodi_dev">twitter account</a>. Also we&rsquo;d be more than happy with more issues, PRs and collaborators in <a href="https://github.com/elcodi/elcodi">GitHub</a>… Let&rsquo;s make something funny and useful together!</p>

<p>See you in Madrid! ;&ndash;)</p>
]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[The Console Component]]></title>
    <link href="http://elcodi-blog.github.io/blog/2014/11/21/console-component/"/>
    <updated>2014-11-21T19:02:40+01:00</updated>
    <id>http://elcodi-blog.github.io/blog/2014/11/21/console-component</id>
    <content type="html"><![CDATA[<p>The next post in the series of <a href="http://elcodi-blog.github.io/blog/categories/one-section-one-component/">&ldquo;One section one component&rdquo;</a>, in support of our friend <a href="https://github.com/mmoreram">Marc Morera</a> in his <a href="https://twitter.com/hashtag/symfonywalk?f=realtime">#symfonywalk</a>, is about the <a href="http://symfony.com/doc/current/components/console">Console component</a>. Marc has had some problems early in his journey, so we want to send him energy and courage for the next steps of the walk. Go Marc! You can send him words of encouragement too in his twitter account <a href="https://twitter.com/mmoreram">@mmoreram</a>!</p>

<h2>Description</h2>

<p>The Console component helps you create console applications. It is like <code>HttpRequest</code> + <code>Routing</code>, but for command line. With this component you can:</p>

<ul>
<li>Create single or multiple commands in an application.</li>
<li>Define and parse command&rsquo;s arguments and options.</li>
<li>Execute a command.</li>
<li>Output information to terminal while processing a command.</li>
<li>Allow automatic management of <code>--help</code> options.</li>
</ul>


<h2>Basic classes</h2>

<ul>
<li><strong><code>Command</code></strong>: configuration of a command with name, parameters, options…</li>
<li><strong><code>InputArgument</code></strong> and <strong><code>InputOption</code></strong>: defines how command-line parameters and options are parsed and passed to a <code>Command</code>.</li>
<li><strong><code>InputInterface</code></strong>: allows read operations from terminal.</li>
<li><strong><code>OutputInterface</code></strong>: encapsulate terminal writing.</li>
<li><strong><code>Application</code></strong>: a group of one or more <code>Command</code>s and <code>Helper</code>s.</li>
</ul>


<h2>Example of usage</h2>

<figure class='code'><figcaption><span></span></figcaption><div class="highlight"><table><tr><td class="gutter"><pre class="line-numbers"><span class='line-number'>1</span>
<span class='line-number'>2</span>
<span class='line-number'>3</span>
<span class='line-number'>4</span>
<span class='line-number'>5</span>
<span class='line-number'>6</span>
<span class='line-number'>7</span>
<span class='line-number'>8</span>
<span class='line-number'>9</span>
<span class='line-number'>10</span>
<span class='line-number'>11</span>
<span class='line-number'>12</span>
<span class='line-number'>13</span>
<span class='line-number'>14</span>
<span class='line-number'>15</span>
<span class='line-number'>16</span>
<span class='line-number'>17</span>
<span class='line-number'>18</span>
<span class='line-number'>19</span>
<span class='line-number'>20</span>
<span class='line-number'>21</span>
<span class='line-number'>22</span>
<span class='line-number'>23</span>
<span class='line-number'>24</span>
<span class='line-number'>25</span>
<span class='line-number'>26</span>
<span class='line-number'>27</span>
<span class='line-number'>28</span>
<span class='line-number'>29</span>
<span class='line-number'>30</span>
<span class='line-number'>31</span>
<span class='line-number'>32</span>
<span class='line-number'>33</span>
<span class='line-number'>34</span>
<span class='line-number'>35</span>
<span class='line-number'>36</span>
<span class='line-number'>37</span>
<span class='line-number'>38</span>
<span class='line-number'>39</span>
<span class='line-number'>40</span>
<span class='line-number'>41</span>
<span class='line-number'>42</span>
<span class='line-number'>43</span>
<span class='line-number'>44</span>
<span class='line-number'>45</span>
<span class='line-number'>46</span>
<span class='line-number'>47</span>
</pre></td><td class='code'><pre><code class='php'><span class='line'><span class="k">class</span> <span class="nc">WriteCommand</span> <span class="k">extends</span> <span class="nx">Command</span>
</span><span class='line'><span class="p">{</span>
</span><span class='line'>    <span class="k">protected</span> <span class="k">function</span> <span class="nf">configure</span><span class="p">()</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="nv">$this</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">setName</span><span class="p">(</span><span class="s1">&#39;write&#39;</span><span class="p">)</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">setDescription</span><span class="p">(</span><span class="s1">&#39;Writes text to a file&#39;</span><span class="p">)</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">addArgument</span><span class="p">(</span>
</span><span class='line'>                <span class="s1">&#39;filename&#39;</span><span class="p">,</span>
</span><span class='line'>                <span class="nx">InputArgument</span><span class="o">::</span><span class="na">REQUIRED</span><span class="p">,</span>
</span><span class='line'>                <span class="s1">&#39;Which file to write?&#39;</span>
</span><span class='line'>            <span class="p">)</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">addArgument</span><span class="p">(</span>
</span><span class='line'>                <span class="s1">&#39;text&#39;</span><span class="p">,</span>
</span><span class='line'>                <span class="nx">InputArgument</span><span class="o">::</span><span class="na">OPTIONAL</span><span class="p">,</span>
</span><span class='line'>                <span class="s1">&#39;Which text to write?&#39;</span>
</span><span class='line'>            <span class="p">)</span>
</span><span class='line'>            <span class="o">-&gt;</span><span class="na">addOption</span><span class="p">(</span>
</span><span class='line'>                <span class="s1">&#39;yell&#39;</span><span class="p">,</span>
</span><span class='line'>                <span class="k">null</span><span class="p">,</span>
</span><span class='line'>                <span class="nx">InputOption</span><span class="o">::</span><span class="na">VALUE_NONE</span><span class="p">,</span>
</span><span class='line'>                <span class="s1">&#39;If set, text will be upper-cased&#39;</span>
</span><span class='line'>            <span class="p">)</span>
</span><span class='line'>        <span class="p">;</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>    <span class="k">protected</span> <span class="k">function</span> <span class="nf">execute</span><span class="p">(</span><span class="nx">InputInterface</span> <span class="nv">$input</span><span class="p">,</span> <span class="nx">OutputInterface</span> <span class="nv">$output</span><span class="p">)</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="nv">$filename</span> <span class="o">=</span> <span class="nv">$input</span><span class="o">-&gt;</span><span class="na">getArgument</span><span class="p">(</span><span class="s1">&#39;filename&#39;</span><span class="p">);</span>
</span><span class='line'>        <span class="nv">$text</span> <span class="o">=</span> <span class="nv">$input</span><span class="o">-&gt;</span><span class="na">getArgument</span><span class="p">(</span><span class="s1">&#39;text&#39;</span><span class="p">);</span>
</span><span class='line'>        <span class="k">if</span> <span class="p">(</span><span class="nv">$input</span><span class="o">-&gt;</span><span class="na">getOption</span><span class="p">(</span><span class="s1">&#39;yell&#39;</span><span class="p">))</span> <span class="p">{</span>
</span><span class='line'>            <span class="nv">$text</span> <span class="o">=</span> <span class="nx">strtoupper</span><span class="p">(</span><span class="nv">$text</span><span class="p">);</span>
</span><span class='line'>        <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>        <span class="k">if</span> <span class="p">(</span><span class="k">false</span> <span class="o">===</span> <span class="nb">file_put_contents</span><span class="p">(</span><span class="nv">$filename</span><span class="p">,</span> <span class="nv">$text</span><span class="p">))</span> <span class="p">{</span>
</span><span class='line'>            <span class="k">throw</span> <span class="k">new</span> <span class="nx">RuntimeException</span><span class="p">(</span><span class="s1">&#39;Error writing to file.&#39;</span><span class="p">);</span>
</span><span class='line'>        <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>        <span class="nv">$output</span><span class="o">-&gt;</span><span class="na">writeln</span><span class="p">(</span><span class="s1">&#39;File was successfully written.&#39;</span><span class="p">);</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'><span class="p">}</span>
</span><span class='line'>
</span><span class='line'><span class="nv">$application</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Application</span><span class="p">();</span>
</span><span class='line'><span class="nv">$application</span><span class="o">-&gt;</span><span class="na">addCommands</span><span class="p">([</span>
</span><span class='line'>    <span class="k">new</span> <span class="nx">WriteCommand</span><span class="p">(),</span>
</span><span class='line'><span class="p">]);</span>
</span><span class='line'><span class="nv">$application</span><span class="o">-&gt;</span><span class="na">run</span><span class="p">();</span>
</span></code></pre></td></tr></table></div></figure>


<p>Now on your command line you can type <code>php console.php write path/to/filename "text to write"</code>.</p>

<p>Usually, the <code>Command</code> should behave like a <code>Controller</code>, this is, checking parameters and passing them to one or more services to do the real work.</p>

<p>You can also add a previous step of interaction with the user, so they can provide any missing or ambiguous information. This part is skipped automatically if the <code>--no-interaction</code> (or <code>-n</code>) is used.</p>

<p>For user interaction, you can use <code>OutputInterface</code> directly, but there are many <code>Helpers</code> you can use, being the <code>QuestionHelper</code><sup id="fnref:1"><a href="#fn:1" rel="footnote">1</a></sup> the most helpful (no pun intended).</p>

<p>Let&rsquo;s see how we can add interaction to our previous example.</p>

<figure class='code'><figcaption><span></span></figcaption><div class="highlight"><table><tr><td class="gutter"><pre class="line-numbers"><span class='line-number'>1</span>
<span class='line-number'>2</span>
<span class='line-number'>3</span>
<span class='line-number'>4</span>
<span class='line-number'>5</span>
<span class='line-number'>6</span>
<span class='line-number'>7</span>
<span class='line-number'>8</span>
<span class='line-number'>9</span>
<span class='line-number'>10</span>
<span class='line-number'>11</span>
<span class='line-number'>12</span>
<span class='line-number'>13</span>
<span class='line-number'>14</span>
<span class='line-number'>15</span>
<span class='line-number'>16</span>
<span class='line-number'>17</span>
<span class='line-number'>18</span>
<span class='line-number'>19</span>
<span class='line-number'>20</span>
<span class='line-number'>21</span>
<span class='line-number'>22</span>
<span class='line-number'>23</span>
<span class='line-number'>24</span>
<span class='line-number'>25</span>
<span class='line-number'>26</span>
<span class='line-number'>27</span>
<span class='line-number'>28</span>
<span class='line-number'>29</span>
<span class='line-number'>30</span>
<span class='line-number'>31</span>
<span class='line-number'>32</span>
<span class='line-number'>33</span>
<span class='line-number'>34</span>
<span class='line-number'>35</span>
<span class='line-number'>36</span>
<span class='line-number'>37</span>
<span class='line-number'>38</span>
<span class='line-number'>39</span>
<span class='line-number'>40</span>
<span class='line-number'>41</span>
<span class='line-number'>42</span>
<span class='line-number'>43</span>
<span class='line-number'>44</span>
<span class='line-number'>45</span>
<span class='line-number'>46</span>
<span class='line-number'>47</span>
<span class='line-number'>48</span>
<span class='line-number'>49</span>
<span class='line-number'>50</span>
<span class='line-number'>51</span>
<span class='line-number'>52</span>
<span class='line-number'>53</span>
<span class='line-number'>54</span>
<span class='line-number'>55</span>
<span class='line-number'>56</span>
<span class='line-number'>57</span>
<span class='line-number'>58</span>
<span class='line-number'>59</span>
<span class='line-number'>60</span>
<span class='line-number'>61</span>
<span class='line-number'>62</span>
<span class='line-number'>63</span>
<span class='line-number'>64</span>
<span class='line-number'>65</span>
<span class='line-number'>66</span>
<span class='line-number'>67</span>
<span class='line-number'>68</span>
<span class='line-number'>69</span>
<span class='line-number'>70</span>
<span class='line-number'>71</span>
<span class='line-number'>72</span>
<span class='line-number'>73</span>
<span class='line-number'>74</span>
</pre></td><td class='code'><pre><code class='php'><span class='line'><span class="k">class</span> <span class="nc">WriteCommand</span> <span class="k">extends</span> <span class="nx">Command</span>
</span><span class='line'><span class="p">{</span>
</span><span class='line'>    <span class="err">…</span>
</span><span class='line'>
</span><span class='line'>    <span class="k">protected</span> <span class="k">function</span> <span class="nf">interact</span><span class="p">(</span><span class="nx">InputInterface</span> <span class="nv">$input</span><span class="p">,</span> <span class="nx">OutputInterface</span> <span class="nv">$output</span><span class="p">)</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="nv">$filename</span> <span class="o">=</span> <span class="nv">$input</span><span class="o">-&gt;</span><span class="na">getArgument</span><span class="p">(</span><span class="s1">&#39;filename&#39;</span><span class="p">);</span>
</span><span class='line'>        <span class="k">if</span> <span class="p">(</span><span class="k">null</span> <span class="o">===</span> <span class="nv">$filename</span><span class="p">)</span> <span class="p">{</span>
</span><span class='line'>            <span class="k">return</span><span class="p">;</span>
</span><span class='line'>        <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>        <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="nv">$this</span><span class="o">-&gt;</span><span class="na">whenBaseDirectoryExists</span><span class="p">(</span><span class="nv">$filename</span><span class="p">))</span> <span class="p">{</span>
</span><span class='line'>            <span class="nv">$this</span><span class="o">-&gt;</span><span class="na">confirmDirectoryCreation</span><span class="p">(</span><span class="nv">$filename</span><span class="p">,</span> <span class="nv">$input</span><span class="p">,</span> <span class="nv">$output</span><span class="p">);</span>
</span><span class='line'>        <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>        <span class="k">if</span> <span class="p">(</span><span class="nv">$this</span><span class="o">-&gt;</span><span class="na">whenFileAlreadyExists</span><span class="p">(</span><span class="nv">$filename</span><span class="p">))</span> <span class="p">{</span>
</span><span class='line'>            <span class="nv">$this</span><span class="o">-&gt;</span><span class="na">confirmFileOverwrite</span><span class="p">(</span><span class="nv">$filename</span><span class="p">,</span> <span class="nv">$input</span><span class="p">,</span> <span class="nv">$output</span><span class="p">);</span>
</span><span class='line'>        <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>        <span class="k">if</span> <span class="p">(</span><span class="k">null</span> <span class="o">===</span> <span class="nv">$input</span><span class="o">-&gt;</span><span class="na">getArgument</span><span class="p">(</span><span class="s1">&#39;text&#39;</span><span class="p">))</span> <span class="p">{</span>
</span><span class='line'>            <span class="nv">$this</span><span class="o">-&gt;</span><span class="na">askForText</span><span class="p">(</span><span class="nv">$input</span><span class="p">,</span> <span class="nv">$output</span><span class="p">);</span>
</span><span class='line'>        <span class="p">}</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>    <span class="k">protected</span> <span class="k">function</span> <span class="nf">whenBaseDirectoryExists</span><span class="p">(</span><span class="nv">$filename</span><span class="p">)</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="k">return</span> <span class="nb">is_dir</span><span class="p">(</span><span class="nb">dirname</span><span class="p">(</span><span class="nv">$filename</span><span class="p">));</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>    <span class="k">protected</span> <span class="k">function</span> <span class="nf">confirmDirectoryCreation</span><span class="p">(</span><span class="nv">$filename</span><span class="p">,</span> <span class="nv">$input</span><span class="p">,</span> <span class="nv">$output</span><span class="p">)</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="nv">$questionHelper</span> <span class="o">=</span> <span class="nv">$this</span><span class="o">-&gt;</span><span class="na">getHelper</span><span class="p">(</span><span class="s1">&#39;question&#39;</span><span class="p">);</span>
</span><span class='line'>        <span class="nv">$question</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">ConfirmationQuestion</span><span class="p">(</span>
</span><span class='line'>            <span class="s1">&#39;Base directory for &quot;&#39;</span> <span class="o">.</span> <span class="nv">$filename</span> <span class="o">.</span> <span class="s1">&#39;&quot; does not exist. Create? [y/n] &#39;</span><span class="p">,</span>
</span><span class='line'>            <span class="k">true</span>
</span><span class='line'>        <span class="p">);</span>
</span><span class='line'>
</span><span class='line'>        <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="nv">$questionHelper</span><span class="o">-&gt;</span><span class="na">ask</span><span class="p">(</span><span class="nv">$input</span><span class="p">,</span> <span class="nv">$output</span><span class="p">,</span> <span class="nv">$question</span><span class="p">))</span> <span class="p">{</span>
</span><span class='line'>            <span class="k">throw</span> <span class="k">new</span> <span class="nx">RuntimeException</span><span class="p">(</span><span class="s1">&#39;Base directory does not exist.&#39;</span><span class="p">);</span>
</span><span class='line'>        <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>        <span class="nb">mkdir</span><span class="p">(</span><span class="nb">dirname</span><span class="p">(</span><span class="nv">$filename</span><span class="p">),</span> <span class="mo">0777</span><span class="p">,</span> <span class="k">true</span><span class="p">);</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>    <span class="k">protected</span> <span class="k">function</span> <span class="nf">whenFileAlreadyExists</span><span class="p">(</span><span class="nv">$filename</span><span class="p">)</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="k">return</span> <span class="nb">file_exists</span><span class="p">(</span><span class="nv">$filename</span><span class="p">);</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>    <span class="k">protected</span> <span class="k">function</span> <span class="nf">confirmFileOverwrite</span><span class="p">(</span><span class="nv">$filename</span><span class="p">,</span> <span class="nv">$input</span><span class="p">,</span> <span class="nv">$output</span><span class="p">)</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="nv">$questionHelper</span> <span class="o">=</span> <span class="nv">$this</span><span class="o">-&gt;</span><span class="na">getHelper</span><span class="p">(</span><span class="s1">&#39;question&#39;</span><span class="p">);</span>
</span><span class='line'>        <span class="nv">$question</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">ConfirmationQuestion</span><span class="p">(</span>
</span><span class='line'>            <span class="s1">&#39;File &quot;&#39;</span> <span class="o">.</span> <span class="nv">$filename</span> <span class="o">.</span> <span class="s1">&#39;&quot; already exists. Overwrite? [y/n] &#39;</span><span class="p">,</span>
</span><span class='line'>            <span class="k">true</span>
</span><span class='line'>        <span class="p">);</span>
</span><span class='line'>
</span><span class='line'>        <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="nv">$questionHelper</span><span class="o">-&gt;</span><span class="na">ask</span><span class="p">(</span><span class="nv">$input</span><span class="p">,</span> <span class="nv">$output</span><span class="p">,</span> <span class="nv">$question</span><span class="p">))</span> <span class="p">{</span>
</span><span class='line'>            <span class="k">throw</span> <span class="k">new</span> <span class="nx">RuntimeException</span><span class="p">(</span><span class="s1">&#39;Can\&#39;t write to file.&#39;</span><span class="p">);</span>
</span><span class='line'>        <span class="p">}</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>    <span class="k">protected</span> <span class="k">function</span> <span class="nf">askForText</span><span class="p">(</span><span class="nv">$input</span><span class="p">,</span> <span class="nv">$output</span><span class="p">)</span>
</span><span class='line'>    <span class="p">{</span>
</span><span class='line'>        <span class="nv">$questionHelper</span> <span class="o">=</span> <span class="nv">$this</span><span class="o">-&gt;</span><span class="na">getHelper</span><span class="p">(</span><span class="s1">&#39;question&#39;</span><span class="p">);</span>
</span><span class='line'>        <span class="nv">$question</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Question</span><span class="p">(</span>
</span><span class='line'>            <span class="s1">&#39;Please enter the content of the file: &#39;</span><span class="p">,</span>
</span><span class='line'>            <span class="s1">&#39;&#39;</span>
</span><span class='line'>        <span class="p">);</span>
</span><span class='line'>
</span><span class='line'>        <span class="nv">$text</span> <span class="o">=</span> <span class="nv">$questionHelper</span><span class="o">-&gt;</span><span class="na">ask</span><span class="p">(</span><span class="nv">$input</span><span class="p">,</span> <span class="nv">$output</span><span class="p">,</span> <span class="nv">$question</span><span class="p">);</span>
</span><span class='line'>        <span class="nv">$input</span><span class="o">-&gt;</span><span class="na">setArgument</span><span class="p">(</span><span class="s1">&#39;text&#39;</span><span class="p">,</span> <span class="nv">$text</span><span class="p">);</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'><span class="p">}</span>
</span></code></pre></td></tr></table></div></figure>


<p><a href="https://gist.github.com/xphere/546d5e90d15c1f88d750">See here the full example</a></p>

<p>Now we&rsquo;re being requested for directory creation, file overwriting, and missing text arguments. Nice!</p>

<h2>Other classes</h2>

<ul>
<li><strong><code>Helpers</code></strong>: Extensions for <code>OutputInterface</code>, to ask questions, show progress bars or tables. You can add your own too, or check the <a href="http://symfony.com/doc/current/components/console/helpers">default ones</a>.</li>
</ul>


<h2>In Symfony2 framework</h2>

<p>Symfony2 detects <code>Command</code> classes in the <code>Command</code> directory of each bundle, and automatically adds them to the console application. As of 2.4, you can also mark services with the tag <code>console.command</code>. You can refer to this great <a href="http://symfony.com/doc/current/cookbook/console/commands_as_services.html">cookbook entry</a>.</p>

<h2>In Elcodi</h2>

<p>In Elcodi we provide commands for things such as <a href="https://github.com/elcodi/Currency/blob/master/Command/CurrencyExchangeRatesPopulateCommand.php">querying currency exchanges</a> or <a href="https://github.com/elcodi/Geo/blob/master/Command/GeoPopulateCommand.php">populating geo entities</a> from third party providers.</p>

<h2>Conclusion</h2>

<p>The <code>Console</code> component brings steroids to your command-line applications at nearly no cost for what you get in return. You can have multiple commands under the same application or <a href="http://symfony.com/doc/current/components/console/single_command_tool.html">just one</a>, you choose. If the <a href="https://getcomposer.org/">current PHP dependency manager</a> uses it, why not you?</p>

<h2>Urls</h2>

<ul>
<li><a href="https://github.com/symfony/Console">Repository</a></li>
<li><a href="http://symfony.com/doc/current/components/console">Documentation</a></li>
<li><a href="https://packagist.org/packages/symfony/console">Packagist</a></li>
</ul>

<div class="footnotes">
<hr/>
<ol>
<li id="fn:1">
<p><code>QuestionHelper</code> is available as of Symfony 2.5, for previous versions use the, now deprecated, <a href="http://symfony.com/doc/2.5/components/console/helpers/dialoghelper.html"><code>DialogHelper</code></a>.<a href="#fnref:1" rev="footnote">&#8617;</a></p></li>
</ol>
</div>

]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[The Security Component]]></title>
    <link href="http://elcodi-blog.github.io/blog/2014/11/19/security-component/"/>
    <updated>2014-11-19T22:39:51+01:00</updated>
    <id>http://elcodi-blog.github.io/blog/2014/11/19/security-component</id>
    <content type="html"><![CDATA[<p>The next in line in our <a href="http://elcodi-blog.github.io/blog/categories/one-section-one-component/">&ldquo;One section, one component&rdquo;</a> series is the <a href="http://symfony.com/doc/current/components/security"><code>Security component</code></a>. It&rsquo;s a complex one, sure, but we&rsquo;ll take a look just to the nuts and bolts of it. Ready? Set… Go!</p>

<h2>Description</h2>

<p>This component brings authentication and authorization to your applications, with implementations for common use cases, like form login, HTTP or X.509 authentication, authorization by user, roles and ACL systems.</p>

<h2>Basic classes</h2>

<ul>
<li><strong>Token</strong>: Stores current user credentials.</li>
<li><strong>Listener</strong>: extract information from the Request by which the user might be authenticated. It should create a valid token and set it into the <strong>SecurityContext</strong><sup id="fnref:1"><a href="#fn:1" rel="footnote">1</a></sup>.</li>
<li><strong>FirewallMap</strong>: maps a <a href="https://github.com/symfony/HttpFoundation/blob/master/RequestMatcher.php"><code>RequestMatcher</code></a> to a set of <code>Listener</code>s.</li>
<li><strong>Firewall</strong>: Integrates the <code>FirewallMap</code> with <code>EventDispatcher</code> and <code>HttpKernel</code> components.</li>
</ul>


<h2>Example of usage</h2>

<figure class='code'><figcaption><span></span></figcaption><div class="highlight"><table><tr><td class="gutter"><pre class="line-numbers"><span class='line-number'>1</span>
<span class='line-number'>2</span>
<span class='line-number'>3</span>
<span class='line-number'>4</span>
<span class='line-number'>5</span>
<span class='line-number'>6</span>
<span class='line-number'>7</span>
<span class='line-number'>8</span>
<span class='line-number'>9</span>
<span class='line-number'>10</span>
<span class='line-number'>11</span>
</pre></td><td class='code'><pre><code class='php'><span class='line'><span class="nv">$exceptionListener</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">ExceptionListener</span><span class="p">(</span> <span class="err">…</span> <span class="p">);</span>
</span><span class='line'><span class="nv">$matcher</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">RequestMatcher</span><span class="p">(</span><span class="s1">&#39;^/admin/&#39;</span><span class="p">);</span>
</span><span class='line'><span class="nv">$listeners</span> <span class="o">=</span> <span class="p">[</span>
</span><span class='line'>  <span class="k">new</span> <span class="nx">AnonymousAuthenticationListener</span><span class="p">(</span> <span class="err">…</span> <span class="p">),</span>
</span><span class='line'>  <span class="k">new</span> <span class="nx">LogoutListener</span><span class="p">(</span> <span class="err">…</span> <span class="p">),</span>
</span><span class='line'><span class="p">];</span>
</span><span class='line'>
</span><span class='line'><span class="nv">$firewallMap</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">FirewallMap</span><span class="p">();</span>
</span><span class='line'><span class="nv">$firewallMap</span><span class="o">-&gt;</span><span class="na">add</span><span class="p">(</span><span class="nv">$matcher</span><span class="p">,</span> <span class="nv">$listeners</span><span class="p">,</span> <span class="nv">$exceptionListener</span><span class="p">);</span>
</span><span class='line'>
</span><span class='line'><span class="nv">$firewall</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Firewall</span><span class="p">(</span><span class="nv">$firewallMap</span><span class="p">,</span> <span class="nv">$dispatcher</span><span class="p">);</span>
</span></code></pre></td></tr></table></div></figure>


<h2>Other classes</h2>

<ul>
<li><strong>UserProvider</strong>: Finds a user given his credentials.</li>
<li><strong>AutheticationEntryPoint</strong>: When a match is found but no authentication info can be extracted by the request, this has the chance to return a specific response asking for credentials. For example, the <a href="https://github.com/symfony/Security/blob/master/Http/EntryPoint/FormAuthenticationEntryPoint.php">FormAuthenticationEntryPoint</a> redirects to a login form.</li>
</ul>


<h2>In Symfony2 framework</h2>

<p>The <a href="https://github.com/symfony/SecurityBundle"><code>SecurityBundle</code></a> integrates this component into Symfony2, reading configuration from <code>security.yml</code> and adding some sane defaults.</p>

<h2>In Elcodi</h2>

<p><a href="https://github.com/elcodi/User"><code>Elcodi/User</code></a> depends on the <code>Security</code>  component for authentication. The main implementation of the <code>CustomerWrapper</code> extracts the current user from the <code>SecurityContext</code>. Also, in <a href="http://bamboo.elcodi.com/">our example application, Bamboo</a>, we depend on the excelent <a href="https://github.com/hwi/HWIOAuthBundle"><code>hwi/oauth-bundle</code></a>, which is a good example of extending this component, for OAuth authentication.</p>

<h2>Conclusion</h2>

<p>Almost every non-trivial application requires some kind of authentication. The <code>Security</code> component gives you all the power you should need, although it may be hard to use standalone. The integration with the framework makes for a much more enjoyable experience. We&rsquo;re already using this component! And you?</p>

<p>Have fun!</p>

<h2>Urls</h2>

<ul>
<li><a href="https://github.com/symfony/Security">Repository</a></li>
<li><a href="http://symfony.com/doc/current/components/security">Documentation</a></li>
<li><a href="https://packagist.org/packages/symfony/security">Packagist</a></li>
</ul>

<div class="footnotes">
<hr/>
<ol>
<li id="fn:1">
<p><a href="http://symfony.com/blog/new-in-symfony-2-6-security-component-improvements"><strong>SecurityContext</strong> is deprecated since Symfony 2.6 in favor of <strong>TokenStorage</strong></a>.<a href="#fnref:1" rev="footnote">&#8617;</a></p></li>
</ol>
</div>

]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[The Routing Component]]></title>
    <link href="http://elcodi-blog.github.io/blog/2014/11/18/the-routing-component/"/>
    <updated>2014-11-18T22:39:54+01:00</updated>
    <id>http://elcodi-blog.github.io/blog/2014/11/18/the-routing-component</id>
    <content type="html"><![CDATA[<p>As a complement to the <a href="http://mmoreram.com/blog/2014/08/07/symfony-walk-zaragoza-madrid/">#SymfonyWalk</a> we start <a href="http://elcodi-blog.github.io/blog/categories/one-section-one-component/">&ldquo;One section, one component&rdquo;</a>, a series of posts about some of the symfony components. Let&rsquo;s start with routing!</p>

<h2>Description</h2>

<p>As each component does, the <a href="https://github.com/symfony/Routing">Routing component</a> focuses and solves a small problem, in this case, matching urls to routes, so we can extract related information, and vice versa.</p>

<p>Things you can do with this component:</p>

<ul>
<li>Load your routes from anywhere into a collection.</li>
<li>Check if a request matches any of the routes.</li>
<li>Extract route-specific info from the request.</li>
<li>Generate a url from a route and route specific info.</li>
</ul>


<h2>Basic classes</h2>

<p>The cast of this component is:</p>

<ul>
<li><strong><code>Route</code></strong>: definition of a route, with path, requirements, options and conditions…</li>
<li><strong><code>RouteCollection</code></strong>: this bundles one or more <code>Routes</code> and allows to configure all of them at once.</li>
<li><strong><code>Matcher</code></strong>: Searches a <code>RouteCollection</code> for a matching uri.</li>
<li><strong><code>RequestContext</code></strong>: Context from the current request.</li>
</ul>


<h2>Example of usage</h2>

<figure class='code'><figcaption><span></span></figcaption><div class="highlight"><table><tr><td class="gutter"><pre class="line-numbers"><span class='line-number'>1</span>
<span class='line-number'>2</span>
<span class='line-number'>3</span>
<span class='line-number'>4</span>
<span class='line-number'>5</span>
<span class='line-number'>6</span>
<span class='line-number'>7</span>
<span class='line-number'>8</span>
<span class='line-number'>9</span>
<span class='line-number'>10</span>
<span class='line-number'>11</span>
<span class='line-number'>12</span>
<span class='line-number'>13</span>
<span class='line-number'>14</span>
<span class='line-number'>15</span>
<span class='line-number'>16</span>
<span class='line-number'>17</span>
<span class='line-number'>18</span>
<span class='line-number'>19</span>
<span class='line-number'>20</span>
<span class='line-number'>21</span>
<span class='line-number'>22</span>
<span class='line-number'>23</span>
</pre></td><td class='code'><pre><code class='php'><span class='line'><span class="nv">$route</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Route</span><span class="p">(</span><span class="s1">&#39;/{name}&#39;</span><span class="p">);</span>
</span><span class='line'><span class="nv">$route</span><span class="o">-&gt;</span><span class="na">setDefaults</span><span class="p">([</span>
</span><span class='line'>    <span class="s1">&#39;_controller&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;GreeterController&#39;</span><span class="p">,</span>
</span><span class='line'><span class="p">]);</span>
</span><span class='line'><span class="nv">$route</span><span class="o">-&gt;</span><span class="na">setRequirements</span><span class="p">([</span>
</span><span class='line'>  <span class="s1">&#39;name&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;[a-z]+&#39;</span><span class="p">,</span>
</span><span class='line'><span class="p">]);</span>
</span><span class='line'>
</span><span class='line'><span class="nv">$routes</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">RouteCollection</span><span class="p">();</span>
</span><span class='line'><span class="nv">$routes</span><span class="o">-&gt;</span><span class="na">add</span><span class="p">(</span><span class="s1">&#39;greet&#39;</span><span class="p">,</span> <span class="nv">$route</span><span class="p">);</span>
</span><span class='line'><span class="nv">$routes</span><span class="o">-&gt;</span><span class="na">addPrefix</span><span class="p">(</span><span class="s1">&#39;/hello&#39;</span><span class="p">);</span>
</span><span class='line'>
</span><span class='line'><span class="nv">$context</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">RequestContext</span><span class="p">();</span>
</span><span class='line'><span class="nv">$matcher</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">UrlMatcher</span><span class="p">(</span><span class="nv">$routes</span><span class="p">,</span> <span class="nv">$context</span><span class="p">);</span>
</span><span class='line'><span class="nv">$parameters</span> <span class="o">=</span> <span class="nv">$matcher</span><span class="o">-&gt;</span><span class="na">match</span><span class="p">(</span><span class="s1">&#39;/hello/fabien&#39;</span><span class="p">);</span>
</span><span class='line'>
</span><span class='line'><span class="cm">/*</span>
</span><span class='line'><span class="cm"> * $parameters === [</span>
</span><span class='line'><span class="cm"> *   &#39;_route&#39; =&gt; &#39;greet&#39;,</span>
</span><span class='line'><span class="cm"> *   &#39;_controller&#39; =&gt; &#39;GreeterController&#39;,</span>
</span><span class='line'><span class="cm"> *   &#39;name&#39; =&gt; &#39;fabien&#39;,</span>
</span><span class='line'><span class="cm"> * ]</span>
</span><span class='line'><span class="cm"> */</span>
</span></code></pre></td></tr></table></div></figure>


<h2>Other classes</h2>

<p>Other supporting actors:</p>

<ul>
<li><strong>Loader</strong>: Loads a <code>RouteCollection</code> from a source.</li>
<li><strong>Generator</strong>: The opposite of <code>Matcher</code>, given a route name and route-specific information, generates the uri.</li>
<li><strong>Dumper</strong>: The opposite of <code>Loader</code>, dumps a <code>RouteCollection</code> in different formats.</li>
<li><strong>Router</strong>: basically a <a href="http://en.wikipedia.org/wiki/Facade_pattern">facade</a> to <code>Matcher</code> and <code>Generator</code>.</li>
</ul>


<h2>In Symfony2 framework</h2>

<p>Symfony2 framework reads routes from routing files with this component, matches the current <code>Request</code> and chooses which <code>Controller</code> and action to run. It also extends the <code>Router</code> so you can use parameter placeholders from <a href="https://github.com/symfony/DependencyInjection"><code>DependencyInjection</code></a> and integrates with the <a href="https://github.com/symfony/Config"><code>Config</code></a> component to allow caching.</p>

<h2>In Elcodi</h2>

<p>In Elcodi, as a library, we try not to couple our very few controllers to a specific route and we leave that responsibility to the layers above. For more complex scenarios, like the <a href="https://github.com/elcodi/MediaBundle"><code>MediaBundle</code></a> and the forthcoming <a href="https://github.com/elcodi/elcodi/tree/ec8fabe99489ae9dd1ef671eefaaa7ac89e24cdb/src/Elcodi/Bundle/PageBundle"><code>PageBundle</code></a>, we implement our own custom <code>Loader</code> so we can route through them.</p>

<h2>Conclusion</h2>

<p>This component deals with the next step just after getting your <a href="http://symfony.com/doc/current/components/http_foundation">HTTP Request</a> and gives you great power and flexibility to split your application into several routes.</p>

<p>I hope you find this component useful!</p>

<h2>Urls</h2>

<ul>
<li><a href="https://github.com/symfony/Routing">Repository</a></li>
<li><a href="http://symfony.com/doc/current/components/routing">Documentation</a></li>
<li><a href="https://packagist.org/packages/symfony/routing">Packagist</a></li>
</ul>

]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[A week of Elcodi #3 (10/11 - 17/11)]]></title>
    <link href="http://elcodi-blog.github.io/blog/2014/11/17/a-week-of-elcodi-number-3/"/>
    <updated>2014-11-17T17:25:20+01:00</updated>
    <id>http://elcodi-blog.github.io/blog/2014/11/17/a-week-of-elcodi-number-3</id>
    <content type="html"><![CDATA[<p>This last week we were working hard on our next milestone: our presentation at the <a href="http://madrid2014.symfony.com">#SymfonyCon</a> on November 27th. <a href="https://github.com/mmoreram">@mmoreram</a> and <a href="https://github.com/alch">@alch</a> will speak about how we&rsquo;re building a flexible e-commerce library on top of best practices. We&rsquo;ll dig into the guts of <a href="http://elcodi.io">Elcodi</a> and talk about the tecnologies we&rsquo;ve been using to decouple and allow our users to customize everything to suit their business needs.</p>

<p>Also, @mmoream started walking this Sunday what he calls the <a href="http://mmoreram.com/blog/2014/08/07/symfony-walk-zaragoza-madrid">#SymfonyWalk</a>, a road-trip between Zaragoza and Madrid that will last for 10 days. All this on foot! We wish Marc good health and good luck in that journey!</p>

<p>In the more technical side, we&rsquo;ve been integrating <a href="https://github.com/elcodi/elcodi/tree/feature/page-component">our soon-to-be-released Elcodi&rsquo;s <code>PageBundle</code></a> into <code>bamboo-admin</code>, so you can add content pages to your stores. This will appear in the next release for sure, so… stay tuned!</p>

<p>Also, our <a href="https://github.com/hwi/HWIOAuthBundle/pull/677">PR for PayPal authentication</a> finally made it into HWI/OAuthBundle. Nice!</p>

<p>Have fun!</p>
]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[A week of Elcodi #2 (3/11 - 10/11)]]></title>
    <link href="http://elcodi-blog.github.io/blog/2014/11/11/a-week-of-elcodi-number-2/"/>
    <updated>2014-11-11T12:22:31+01:00</updated>
    <id>http://elcodi-blog.github.io/blog/2014/11/11/a-week-of-elcodi-number-2</id>
    <content type="html"><![CDATA[<p>We&rsquo;ve been putting efforts into making better issues and PRs and closing older ones for a better GitHub experience for our contributors and users.</p>

<p>The PayPal web checkout has been reintegrated into the <a href="https://github.com/elcodi/bamboo-store/pull/56">bamboo store</a> meaning that the frontend store is able to receive real payments, other than integrating a <a href="https://github.com/elcodi/bamboo-store/pull/56">dummy payment module</a> for testing purposes. Next step is to integrate <a href="https://github.com/PaymentSuite/StripeBundle">stripe</a> or <a href="https://github.com/PaymentSuite/PaymillBundle">paymill</a>, which are much more developer-friendly. Stay tuned with the <a href="https://github.com/PaymentSuite">PaymentSuite</a> updates to see what&rsquo;s coming from there too!</p>

<p>Also, there&rsquo;s a <a href="https://github.com/hwi/HWIOAuthBundle/pull/677">new PR in HWI/OAuth</a> from our team to add PayPal login support.</p>

<p>We&rsquo;ve done our first hackaton. We met with some friends to talk about the project, about our implementations and about how to approach the development of our Page Component. It has definitely been the first of many more events like this.</p>

<p>And finally, as you may know, Elcodi will speak at the <a href="http://madrid2014.symfony.com/">SymfonyCon</a> at the end of November. We will talk about some cool things we&rsquo;ve been working on during last months and since we want to celebrate this, part of the team will be walking the <em>330km route</em> between Zaragoza and Madrid. You can read more about this adventure in these posts:</p>

<ul>
<li><a href="http://mmoreram.com/blog/2014/08/07/symfony-walk-zaragoza-madrid/">Symfony Walk</a></li>
<li><a href="http://mmoreram.com/blog/2014/08/12/one-section-one-component/">One section, one component</a></li>
</ul>

]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[A week of Elcodi #1 (27/10 - 3/11)]]></title>
    <link href="http://elcodi-blog.github.io/blog/2014/11/04/a-week-of-elcodi-number-1/"/>
    <updated>2014-11-04T09:32:57+01:00</updated>
    <id>http://elcodi-blog.github.io/blog/2014/11/04/a-week-of-elcodi-number-1</id>
    <content type="html"><![CDATA[<p>It is time to be more vocal about what we are doing and share with the community how we are moving forward along our roadmap and the progress we are making.</p>

<p>Inspired by the <a href="http://symfony.com/blog/category/a-week-of-symfony">famous symfony weekly bulletin</a>, we would like to do something similar: <em>A week of Elcodi</em>, a series of post assembled in turn by each member of the team.</p>

<p>This week we&rsquo;ve been working on <a href="https://github.com/elcodi/bamboo-store/issues/44">social connectivity for our bamboo store</a>, allowing our users to log in from a variety of OAuth services through integration of <a href="https://github.com/hwi/HWIOAuthBundle">HWI/OAuthBundle</a> in our project.
A thin layer and a new entity <a href="https://github.com/elcodi/bamboo-store/blob/2134302656ae13768ab8e82e54053d01f105d861/src/Elcodi/StoreConnectBundle/Entity/Authorization.php#L31"><code>Authorization</code></a> stores and retrieves links between our <a href="https://github.com/elcodi/elcodi/blob/master/src/Elcodi/Component/User/Entity/Interfaces/CustomerInterface.php"><code>CustomerInterface</code></a> and the OAuth token. And voilà! You can login with your GitHub account in two clicks!</p>

<p>Sticking with our bamboo store, we prepared a feature branch with PayPal <a href="https://developer.paypal.com/docs/integration/web/web-checkout/">web checkout</a> integration. It has been developed on top of the <a href="https://github.com/PaymentSuite">PaymentSuite</a> project. You can check out the changes <a href="https://github.com/elcodi/bamboo-store/compare/features/paypal-payment?expand=1">here</a>.</p>

<p>We have also been working on a <em>Finite-state machine</em>. Until now we were managing <a href="https://github.com/elcodi/elcodi/blob/master/src/Elcodi/Component/Cart/Entity/Order.php#L38"><code>Order</code></a> and <a href="https://github.com/elcodi/elcodi/blob/master/src/Elcodi/Component/Cart/Entity/OrderLine.php#L34"><code>OrderLine</code></a> state changes using an <a href="https://github.com/elcodi/elcodi/blob/master/src/Elcodi/Component/Cart/Services/OrderStateManager.php#L28">hardwired implementation</a> which was very specific to the <code>Cart</code> component, while any logic implementing a FSM should be reusable. While waiting for Symfony to implement its own state machine in the near futire, we wrote a very simple and useful component that can be used in any project. You can check and review the <a href="https://github.com/elcodi/elcodi/pull/354">pull request</a></p>

<p>In terms of specific e-commerce features, we just merged some improvements to the Shipping component and Bundle. See the <a href="https://github.com/elcodi/elcodi/pull/309">Pull Request</a>.</p>

<p>Stay tuned!</p>
]]></content>
  </entry>
  
  <entry>
    <title type="html"><![CDATA[The family grows]]></title>
    <link href="http://elcodi-blog.github.io/blog/2014/10/16/welcome-berny/"/>
    <updated>2014-10-16T16:09:40+02:00</updated>
    <id>http://elcodi-blog.github.io/blog/2014/10/16/welcome-berny</id>
    <content type="html"><![CDATA[<p>Today a new friend has join the team, meet Berny Cantos!</p>

<p>Berny is a seasoned web developer and of course a Symfony lover. He is one of those great old-school coders that forged
their stamina the <em>hard way</em>, out of C/C++ development, before diving into the LAMP world.</p>

<p>He will be helping step up our commitment with the open source community and harden the foundations of our codebase.</p>

<p><img src="http://s3-eu-west-1.amazonaws.com/elcodi-static-assets/images/people/berny.jpg" alt="All Right!" /></p>

<p>You can reach him on <a href="https://github.com/xphere">GitHub</a>, Twitter at <a href="https://twitter.com/xphere">@xphere</a> and
<a href="https://www.linkedin.com/in/bernycantos">LinkedIn</a></p>

<p>Welcome Berny!</p>
]]></content>
  </entry>
  
</feed>