Open up a Terminal again, cd into learning folder and run:

composer require "laravel-doctrine/orm:1.1.*"

Likewise, install uuid-doctrine:

composer require ramsey/uuid-doctrine

Open config/app.php file and add into providers array the following line:

In the same file, look for aliases array and add the following lines:

Once you have added it, open up a terminal and run the following command to publish configuration above:

php artisan vendor:publish --tag="config"

Doctrine configuration

The config/doctrine.php file must be to modified as follows:

We edit the line:

For:

In this line, we are changing the way to map the entities, of annotations to configuration files (congif). There are several ways to map our entities with the tables in the database (annotations, yaml, xml, configuration files, static function in the entities), we chose configuration files because in this way, the definition of metadatas is separated of the entities and it adapts better configuration files used by Laravel.

Then, place the ‘mapping_file’ item below the ‘connection’ item, as follows:

With this, we are saying that the object-relational mapping config file will be called: mappings.php.

Then,  to prevent that Doctrine searches the entities throughout the app folder, set the namespace where it will search, in this case App\Domain:

We change:

For:

Finally, in the same file, add the data type uuid for Doctrine

Change:

To:

Working with Domain

Inside app/ directory, create a new folder called Domain and into this, create another folder calledTeacher, in this folder, create the Teacher.php file which will contain the Teacher entity, as shown in the picture:

The Teacher entity will have the attributes: $id and $name, in addition, it will contain the setters and getters methods, additionally it will contain a whitelist() method which will return an array of attributes which can be assigned, as follows:

Mapping the entity with the table

Now, we must map the entity, for that, create the config/mappings.php and put the following:

With this, Doctrine will know that the Teacher class  will be recorded in the teachers table, and this will have an identifier field called id which will be generate through the UuidGenerator class (we also can generate this id if we create a constructor in the entity and inside it we put $this->id = Ramsey\Uuid\Uuid::uuid4() ) and the name field of type string.

Creating the database

On the mysql command line, create a empty database called learning:

create database learning;

We can do it using phpmyadmin or another mysql client.

Database Configuration

Edit the following fields into the Laravel config file .env according your local database settings:

Run the following command to create the teachers table in the database through the mapping scheme:

php artisan doctrine:schema:create

Repository Interface

Now, let’s create the TeacherRepository.php file in app/Domain/Teacher as shown in the picture:

In this file we will create the TeacherRepository interface, which will have the methods: create,update, save, delete, find y findAll, those methods will be implemented after using Doctrine.

Testing

Let’s create a test class using the Laravel artisan command:

php artisan make:test TeacherRepositoryTest

This command will create us the TeacherRepositoryTest.php in /test folder, in this file we will test methods of the repository, as shown in the following code:

Doctrine Implementation

Create Infrastructure folder into app/ folder and into this folder create DoctrineBaseRepository.php file, as shown below:

In this file let’s create the DoctrineBaseRepository class, which extends of EntityRepository class of Doctrine. DoctrineBaseRepository will have the common and necessary methods which all the next repositories will have.

The methods create() and update() create and update respectively the object by assigning its attributes through the method prepare() and the methods save() and delete() as their names imply, persist and remove those objects in the database.

Then, into the app/Infrastructure let’s create the Teacher folder and inside it let’s create the DoctrineTeacherRepository.php file, as shown in the following image:

In this file will be the DoctrineTeacherRepository class which will be the repository of persistence and recovery of data from the Teacher entity, this will extend the previouslyDoctrineBaseRepository class created to inherit all the basic and necessary methods and it will implement the TeacherRepository interface. Here you can add any other particular method that business logic required, for now we won’t need any other and we will leave it without additional methods:

Let’s open the app/Providers/AppServiceProvider.php file and into the register() method add the code which will instance DoctrineTeacherRepository class when the TeacherRepository interface is used.

Testing the repository

With this we can use the repository created.

To test if it works, let’s use the TeacherRepositoryTest class made earlier, running the command:

vendor/bin/phpunit

We should get the following answer:

This tells us that through the repository we were able to create, update, view and delete a record in the database.