Skip to content

[WIP] Adding a testing/database cookbook #2407

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Apr 26, 2013
Merged

[WIP] Adding a testing/database cookbook #2407

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2823a40
Adding a database cookbook with the topics unit tests and config_test…
Sgoettschkes Mar 30, 2013
00d24fa
Making some minor bugfixes to the testing/database cookbook. Added di…
Sgoettschkes Mar 30, 2013
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Making some minor bugfixes to the testing/database cookbook. Added di… 
…fferent code examples
  • Loading branch information
@Sgoettschkes
Sgoettschkes committed Mar 30, 2013
commit 00d24fa324130a0a46cf26614727789f0e8cf54b
48 changes: 34 additions & 14 deletions cookbook/testing/database.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,16 +59,16 @@ easy to pass a mock object within a test::
->method('getBonus')
->will($this->returnValue(1100));

// Now, mock tthe repository so it returns the mock of the employee
// Now, mock the repository so it returns the mock of the employee
$employeeRepository = $this->getMockBuilder('\Doctrine\ORM\EntityRepository')
->disableOriginalConstructor()
->getMock();
$employeeRepository->expects($this->once())
->method('__call')
->method('find')
->will($this->returnValue($employee));

// Last, mock the EntityManager to return the mock of the repository
$entityManager = $this->getMockBuilder('\Doctrine\ORM\EntityManager')
$entityManager = $this->getMockBuilder('\Doctrine\Common\Persistence\ObjectManager')
->disableOriginalConstructor()
->getMock();
$entityManager->expects($this->once())
Expand All @@ -83,14 +83,6 @@ easy to pass a mock object within a test::
We are building our mocks from the inside out, first creating the employee which
gets returned by the ``Repository`` which itself gets returned by the ``EntityManager``.
This way, no real class is involved in testing.

.. note::

As a ``Repository`` doesn't have a ``find()`` method but uses the magic method
``__call``, you cannot define a mock method on ``find()`` but must instead use
``__call``. It's possible to implement the ``find()`` method in your ``Repository``
and use it when mocking. In this case, make sure to mock your ``Repository``
class instead of the generic ``EntityRepository``.

Changing database settings for functional tests
-----------------------------------------------
Expand All @@ -100,15 +92,43 @@ Most of the time you want to use a dedicated database connection to make sure
not to overwrite data you entered when developing the application and also
to be able to clear the database before every test.

To do this, you can specify the database configuration inside your ``app/config/config_test.yml``::
To do this, you can specify a database configuration which overwrites the default
configuration:

.. code-block:: yaml

# app/config/config_test.yml
doctrine:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should be:

[...] inside your ``app/config/config_test.yml``:

.. code-block:: yaml

    doctrine:
        # ...

# ...
dbal:
host: localhost
dbname: testdb
user: testdb
password: testdb
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add other formats as well


Make sure that your database runs on localhost and has the defined database and
user credentials set up.
.. code-block:: xml

<!-- app/config/config_test.xml -->
<doctrine:config>
<doctrine:dbal
host="localhost"
dbname="testdb"
user="testdb"
password="testdb"
>
</doctrine:config>

.. code-block:: php

// app/config/config_test.php
$configuration->loadFromExtension('doctrine', array(
'dbal' => array(
'host' => 'localhost',
'dbname' => 'testdb',
'user' => 'testdb',
'password' => 'testdb',
),
));

Make sure that your database runs on localhost and has the defined database and
user credentials set up.