From 86b29370786de35cc40e3424e09c3cf48551ee28 Mon Sep 17 00:00:00 2001
From: msquare <msquare@notrademark.de>
Date: Mon, 6 Aug 2018 12:50:34 +0200
Subject: added comments and renamed short method to url generators

---
 src/Routing/LegacyUrlGenerator.php     | 11 ++++++++---
 src/Routing/RoutingServiceProvider.php |  7 +++++--
 src/Routing/UrlGenerator.php           |  9 +++++++--
 src/Routing/UrlGeneratorInterface.php  |  5 ++++-
 src/helpers.php                        |  2 +-
 5 files changed, 25 insertions(+), 9 deletions(-)

(limited to 'src')

diff --git a/src/Routing/LegacyUrlGenerator.php b/src/Routing/LegacyUrlGenerator.php
index f17bdf88..e2434e1f 100644
--- a/src/Routing/LegacyUrlGenerator.php
+++ b/src/Routing/LegacyUrlGenerator.php
@@ -2,14 +2,19 @@
 
 namespace Engelsystem\Routing;
 
+/**
+ * Provides urls when webserver rewriting is disabled.
+ * 
+ * The urls have the form <app url>/index.php?p=<path>&<parameters>
+ */
 class LegacyUrlGenerator extends UrlGenerator
 {
     /**
      * @param string $path
      * @param array  $parameters
-     * @return string
+     * @return string urls in the form <app url>/index.php?p=<path>&<parameters>
      */
-    public function to($path, $parameters = [])
+    public function link_to($path, $parameters = [])
     {
         $page = ltrim($path, '/');
         if (!empty($page)) {
@@ -17,7 +22,7 @@ class LegacyUrlGenerator extends UrlGenerator
             $parameters = array_merge(['p' => $page], $parameters);
         }
 
-        $uri = parent::to('index.php', $parameters);
+        $uri = parent::link_to('index.php', $parameters);
         $uri = preg_replace('~(/index\.php)+~', '/index.php', $uri);
 
         return $uri;
diff --git a/src/Routing/RoutingServiceProvider.php b/src/Routing/RoutingServiceProvider.php
index 021840c3..beaa6a94 100644
--- a/src/Routing/RoutingServiceProvider.php
+++ b/src/Routing/RoutingServiceProvider.php
@@ -1,16 +1,19 @@
 <?php
-
 namespace Engelsystem\Routing;
 
 use Engelsystem\Container\ServiceProvider;
 
+/**
+ * Registers the url generator depending on config.
+ */
 class RoutingServiceProvider extends ServiceProvider
 {
+
     public function register()
     {
         $config = $this->app->get('config');
         $class = UrlGenerator::class;
-        if (!$config->get('rewrite_urls', true)) {
+        if (! $config->get('rewrite_urls', true)) {
             $class = LegacyUrlGenerator::class;
         }
 
diff --git a/src/Routing/UrlGenerator.php b/src/Routing/UrlGenerator.php
index 8dd52271..a8fc88c1 100644
--- a/src/Routing/UrlGenerator.php
+++ b/src/Routing/UrlGenerator.php
@@ -2,14 +2,19 @@
 
 namespace Engelsystem\Routing;
 
+/**
+ * Provides urls when rewriting on the webserver is enabled. (default)
+ * 
+ * The urls have the form <app url>/<path>?<parameters>
+ */
 class UrlGenerator implements UrlGeneratorInterface
 {
     /**
      * @param string $path
      * @param array  $parameters
-     * @return string
+     * @return string url in the form [app url]/[path]?[parameters]
      */
-    public function to($path, $parameters = [])
+    public function link_to($path, $parameters = [])
     {
         $path = '/' . ltrim($path, '/');
         $request = app('request');
diff --git a/src/Routing/UrlGeneratorInterface.php b/src/Routing/UrlGeneratorInterface.php
index d97da30d..17385bc2 100644
--- a/src/Routing/UrlGeneratorInterface.php
+++ b/src/Routing/UrlGeneratorInterface.php
@@ -2,6 +2,9 @@
 
 namespace Engelsystem\Routing;
 
+/**
+ * To switch between different URL schemes.
+ */
 interface UrlGeneratorInterface
 {
     /**
@@ -9,5 +12,5 @@ interface UrlGeneratorInterface
      * @param array  $parameters
      * @return string
      */
-    public function to($path, $parameters = []);
+    public function link_to($path, $parameters = []);
 }
diff --git a/src/helpers.php b/src/helpers.php
index 1915eb86..8b1f0cee 100644
--- a/src/helpers.php
+++ b/src/helpers.php
@@ -124,7 +124,7 @@ function url($path = null, $parameters = [])
         return $urlGenerator;
     }
 
-    return $urlGenerator->to($path, $parameters);
+    return $urlGenerator->link_to($path, $parameters);
 }
 
 /**
-- 
cgit v1.2.3-54-g00ecf