Just a few years ago web applications were still built in such a way that interactions with the database and view were executed directly by the application itself. Yet with the increasing popularity of mobile apps and JavaScript frameworks, central30<\/p>\n
Laravel is an open-source framework written in PHP that was initiated by Taylor Otwell in 2011. It has subsequently enjoyed great popularity thanks to its simplicity and flexibility, and it also scores with its community spread around the world.<\/p>\n
The term \u2018RESTful API\u2019 is surely a known expression for many of you. To examine this more closely, however, we first need to understand what \u2018REST\u2019 actually stands for and what principles it follows.<\/p>\n
REST is short for \u2018RE<\/strong>presentational S<\/strong>tate T<\/strong>ransfer\u2019, and it designates a programming paradigm for communication between the applications via a stateless protocol (usually HTTP). This is particularly relevant for distributed systems, particularly for web services.<\/p>\n In REST-compatible APIs the resources represent the endpoints and HTTP methods represent the associated actions. Which action should be initiated with which mode of access is defined precisely:<\/p>\n The HTTP methods HEAD<\/strong>, OPTIONS<\/strong>, CONNECT<\/strong> and TRACE<\/strong> are optional, and are normally not required for CRUD operations. It is also important to point out here that adding an implementation of CONNECT or TRACE could affect the security of the application.<\/p>\n When it comes to data storage, be it a new create or an update, opinions are divided as to whether one should use POST, PUT or indeed PATCH (partial update).<\/p>\n The following examples are based on making updates to resources using PUT. PUT means creating or updating a resource at a defined location.<\/p>\n What also defines PUT is its idempotence. In other words, repeated requests using the same data will in fact only result in a single change.<\/p>\n Originally this framework was solely intended to be an improved alternative to the already popular CodeIgniter<\/a> framework, since this lacked certain features such as authentication-related functions.<\/p>\n Over time, however, its scope of functions increased substantially, bringing with it both support for dependency injections and its own template engine (\u2018Blade\u2019).<\/p>\n A further breakthrough occurred in 2012 with the \u2018Artisan\u2019 command-line tool, which enabled all interactions to be executed directly with the framework via the console. This was also followed by support for a still wider range of database systems.<\/p>\n With Version 4 the Laravel framework could then be loaded and managed wholly via Composer, which increased its expandability accordingly and so gave developers still more freedoms.<\/p>\n Further information on this is available directly on the Laravel framework homepage<\/a>.<\/p>\n For the following examples we assume that the Laravel framework has already been installed and is executable. It is of no relevance whether this is done via Homestead<\/a>, Composer or indeed by means of a manual installation of a published release from GitHub. The database connection should also already be configured and functioning.<\/p>\n For the following example we assume that the model name is identical to the resource name. This is not strictly necessary but it is very helpful for promoting traceability.<\/p>\n As the resource, we will create a \u2018note\u2019 that features a \u2018Subject\u2019 and a \u2018Body\u2019 of text.<\/p>\n Let us start by creating the model, including migration using the \u2018Artisan<\/a>\u2019 command-line tool supplied with Laravel.<\/p>\n To do this we navigate, using the terminal (Linux) or the prompt (Windows) directly to the project folder and enter the following command:<\/p>\n php artisan make:model Note -m<\/strong><\/p>\n This command generates a new model called \u2018Note\u2019, and the optional parameter \u2018m\u2019 specifies that an appropriate migration is to be created along with it. The model just created is located at .\/app\/Note.php<\/strong> and the related migration is at .\/database\/migrations\/YYYY_MM_DD_XXXXXX_create_notes_table.php<\/strong>.<\/p>\n Let us first look at the migration.<\/p>\n The up()<\/strong> and down()<\/strong> methods are used to execute the migration and to reverse it, respectively.<\/p>\n The line $table->increments(‚id‘)<\/strong> specifies that an INT field is created for this, with Auto Increment as the primary key. The instruction $table->timestamps()<\/strong> ensures that the \u2018created_at\u2019 and \u2018updated_at\u2019 fields, which are managed by Laravel, are also created. Whether these should in fact be used or not can also be configured directly within the model, but the above is used as standard.<\/p>\n Let us now add our two fields, \u2018Subject\u2019 and \u2018Body\u2019, to the migration just created, so that the up()<\/strong> method finally looks as follows:<\/p>\n We can now run the migration using the following command:<\/p>\n php artisan migrate<\/strong><\/p>\n Should you run into an error such as \u2018Specified key was too long error<\/em><\/strong>\u2019<\/em>, the following step may help.<\/p>\n For this, we extend the app service provider at .\/app\/Providers\/AppServiceProvider.php<\/strong> as follows and then repeat the previous step:<\/p>\n Let us now return to our model, \u2018Note\u2019. We will add the \u2018protected\u2019-attribute ‚fillable‘ to this and specify which of its fields can be populated in the database.<\/p>\n Database seeding is understood as the filling (populating) of a database or database table (in relational systems) with test data. These data are normally generated dynamically using the random principle.<\/p>\n Let us now use the following command to create a seeder class that will fill our Notes table with test data:<\/p>\n php artisan make:seeder NotesSeeder<\/strong><\/p>\n Next we open the seeder class just created at .\/database\/seeds\/NotesSeeder.php<\/strong> and enter the following:<\/p>\n The faker class enables random pseudo-content to be generated, selectable by type. First, the database table is cleared, so that with each execution of the seeder we can start afresh. A loop is now used to generate and store 200 random entries. Next, to run the seeder, let us make use of Artisan again:<\/p>\n php artisan db:seed –class=NotesSeeder<\/strong><\/p>\n Should we have multiple seeder classes, it would be simpler to add these to the central \u2018database seeder\u2019 by registering the individual seeder classes we have created in the run()<\/strong> method of the DatabaseSeeder()<\/strong> class in the same directory.<\/p>\n Now we can use the Artisan seed command to execute all the seeders registered in the DatabaseSeeder()<\/strong> without specifying a particular class.<\/p>\n php artisan db:seed<\/strong><\/p>\n In order for us to interact with the data, we require a controller to manage the communication between the client and the database. In this case, however, we require what is known as a resource controller – that is, one that implements at least the following actions: index()<\/strong>, store()<\/strong>, update()<\/strong> and destroy()<\/strong>. To do this, we use Artisan again:<\/p>\n php artisan make:controller NotesController<\/strong><\/p>\n The newly created NotesController()<\/strong> is located at .\/app\/Http\/Controllers\/NotesController.php<\/strong>. Let us now create the actions listed above and implement the basic behavior.<\/p>\n If there are more than one resource controller, it would make sense to create a base resource controller and allow the various resource controllers to inherit from this. This gives the advantage of being able to use the base behavior in each controller while also allowing specific actions to be overwritten for individual controllers.<\/p>\n Now that the basic CRUD behavior is implemented, the routes must be defined. To do this we open the file .\/routes\/api.php<\/strong> and add the following lines to it:<\/p>\n The route configuration of Laravel makes it possible by this means to route an endpoint directly to a resource controller<\/a>.For this purpose Laravel has reserved specific actions for itself with each controller. These are those that we created previously with NotesController()<\/strong>. The following table gives an indication of the URL structure for such a resource controller and of which action is present behind which HTTP method.<\/p>\nHTTP methods define actions<\/h3>\n
\n
\nLoads information of the desired resource from the server, causing no side effects. According to the specification, GET requests must be \u2018secure\u2019, i.e. a request may not have any effects on the resource. This behavior is termed nullipotent.<\/li>\n
\nCreates a new resource in the appropriate resource master using the data transmitted. With each invocation it creates new resources rather than returning the equivalents again. This behavior is termed not idempotent.<\/li>\n
\nUpdates an existing resource using the data transmitted. Subsequent invocations do not cause further side effects. In contrast to POST, this behavior is here designated as idempotent.<\/li>\n
\nDeletes the requested resource, and similarly to PUT, its behavior is also idempotent.<\/li>\n<\/ul>\nStoring data: POST vs. PUT<\/h3>\n
Integration of REST in Laravel<\/h2>\n
Creating a resource<\/h2>\n
<?php\r\n\r\nuse Illuminate\\Support\\Facades\\Schema;\r\nuse Illuminate\\Database\\Schema\\Blueprint;\r\nuse Illuminate\\Database\\Migrations\\Migration;\r\n\r\nclass CreateNotesTable extends Migration\r\n{\r\n \/**\r\n * Run the migrations.\r\n *\r\n * @return void\r\n *\/\r\n public function up()\r\n {\r\n Schema::create('notes', function (Blueprint $table) {\r\n $table->increments('id');\r\n $table->timestamps();\r\n });\r\n }\r\n\r\n \/**\r\n * Reverse the migrations.\r\n *\r\n * @return void\r\n *\/\r\n public function down()\r\n {\r\n Schema::dropIfExists('notes');\r\n }\r\n}\r\n<\/pre>\npublic function up()\r\n{\r\n\tSchema::create('notes', function (Blueprint $table) {\r\n\t\t$table->increments('id');\r\n\t\t$table->string('subject');\r\n\t\t$table->text('body');\r\n\t\t$table->timestamps();\r\n\t});\r\n}<\/pre>\nuse Illuminate\\Support\\Facades\\Schema;\r\n\r\npublic function boot()\r\n{\r\n\tSchema::defaultStringLength(191);\r\n}<\/pre>\n<?php\r\n\r\nnamespace App;\r\n\r\nuse Illuminate\\Database\\Eloquent\\Model;\r\n\r\nclass Note extends Model\r\n{\r\n\r\n\t\/**\r\n\t * @var array\r\n\t *\/\r\n\tprotected $fillable = ['subject', 'body'];\r\n}<\/pre>\nDatabase seeding<\/h2>\n
<?php\r\n\r\nuse Illuminate\\Database\\Seeder;\r\nuse App\\Note;\r\n\r\nclass NotesSeeder extends Seeder\r\n{\r\n\t\/**\r\n\t * Run the database seeds.\r\n\t *\r\n\t * @return void\r\n\t *\/\r\n\tpublic function run()\r\n\t{\r\n\t\t\/\/ truncate already existing data\r\n\t\tNote::truncate();\r\n\r\n\t\t\/\/ make instance of the Faker-class\r\n\t\t$faker = \\Faker\\Factory::create();\r\n\r\n\t\t\/\/ insert some random generated records\r\n\t\tfor ($i = 0; $i < 200; $i++) {\r\n\t\t\tNote::create([\r\n\t\t\t\t'subject' => $faker->sentence(),\r\n\t\t\t\t'body' => $faker->paragraph(),\r\n\t\t\t]);\r\n\t\t}\r\n\t}\r\n}<\/pre>\n<?php\r\n\r\nuse Illuminate\\Database\\Seeder;\r\n\r\nclass DatabaseSeeder extends Seeder\r\n{\r\n\t\/**\r\n\t * Run the database seeds.\r\n\t *\r\n\t * @return void\r\n\t *\/\r\n\tpublic function run()\r\n\t{\r\n\t\t$this->call( NotesSeeder::class );\r\n\t}\r\n}<\/pre>\nCreating a resource controller<\/h2>\n
<?php\r\n\r\nnamespace App\\Http\\Controllers;\r\n\r\nuse Illuminate\\Http\\Request;\r\nuse App\\Note;\r\n\r\nclass NotesController extends Controller\r\n{\r\n\t\/**\r\n\t * Index function for general listing.\r\n\t *\r\n\t * @param Request $request\r\n\t *\r\n\t * @return \\Illuminate\\Http\\JsonResponse\r\n\t *\/\r\n\tpublic function index(Request $request)\r\n\t{\r\n\t\t$notes = Note::all();\r\n\r\n\t\treturn response()->json($notes);\r\n\t}\r\n\r\n\r\n\t\/**\r\n\t * Store-Action\r\n\t *\r\n\t * @param Request $request\r\n\t *\r\n\t * @return \\Illuminate\\Http\\JsonResponse\r\n\t *\/\r\n\tpublic function store(Request $request)\r\n\t{\r\n\t\t$note = Note::create($request->all());\r\n\r\n\t\treturn response()->json($note);\r\n\t}\r\n\r\n\r\n\t\/**\r\n\t * Show-Action\r\n\t *\r\n\t * @param Request $request\r\n\t * @param int $id\r\n\t *\r\n\t * @return \\Illuminate\\Http\\JsonResponse\r\n\t *\/\r\n\tpublic function show(Request $request, $id)\r\n\t{\r\n\t\t$note = Note::find($id);\r\n\r\n\t\treturn response()->json($note);\r\n\t}\r\n\r\n\r\n\t\/**\r\n\t * Update-Action\r\n\t *\r\n\t * @param Request $request\r\n\t * @param int $id\r\n\t *\r\n\t * @return \\Illuminate\\Http\\JsonResponse\r\n\t *\/\r\n\tpublic function update(Request $request, $id)\r\n\t{\r\n\t\t$note = Note::findOrFail($id);\r\n\t\t$note->update($request->all());\r\n\r\n\t\treturn response()->json($note);\r\n\r\n\r\n\t}\r\n\r\n\r\n\t\/**\r\n\t * Destroy-Action\r\n\t *\r\n\t * @param Request $request\r\n\t * @param int $id\r\n\t *\r\n\t * @return \\Illuminate\\Http\\JsonResponse\r\n\t *\/\r\n\tpublic function destroy(Request $request, $id)\r\n\t{\r\n\t\tNote::find($id)->delete();\r\n\r\n\t\treturn response()->json([], 204);\r\n\t}\r\n}<\/pre>\nRegistering API routes<\/h2>\n
Route::resource('notes', 'NotesController');<\/pre>\n