caffeina-core / core

classes/CLI.php

Doc Comments +1 added lines, -1 removed lines

@@ -116,7 +116,7 @@
     /**
      * Dispatch the router
      * @param  string[] $args The arguments array.
-     * @return boolean  True if route was correctly dispatched.
+     * @return null|boolean  True if route was correctly dispatched.
      */
     public static function run($args=null){
       if($args) {

classes/Errors.php

Doc Comments +3 added lines

@@ -57,6 +57,9 @@
       return true;
     }
 
+    /**
+     * @param ErrorException $e
+     */
     public static function traceException($e){
       switch(self::$mode){
           case self::HTML :

classes/FileSystem/Native.php

Doc Comments +3 added lines

@@ -27,6 +27,9 @@
         return $this->exists($path) ? file_get_contents($this->realPath($path)) : false;
     }
 
+    /**
+     * @param string|false $data
+     */
     public function write($path, $data){
         $r_path = $this->realPath($path);
         if ( ! is_dir($r_dir = dirname($r_path)) ) @mkdir($r_dir,0775,true);

classes/HTTP.php

Doc Comments +6 added lines

@@ -18,6 +18,9 @@ 
   protected static $headers     = [];
   protected static $last_info   = null;
 
+  /**
+   * @param string $method
+   */
   protected static function request($method, $url, $data=[], array $headers=[], $data_as_json=false, $username=null, $password = null){
     $http_method = strtoupper($method);
     $ch = curl_init($url);
@@ -97,6 +100,9 @@ 
     return static::request('get',$url,$data,$headers,false,$username,$password);
   }
 
+  /**
+   * @param string $url
+   */
   public static function post($url,$data=null,array $headers=[], $username = null, $password = null){
     return static::request('post',$url,$data,$headers,static::$json_data,$username,$password);
   }

classes/Session.php

Doc Comments +4 added lines, -5 removed lines

@@ -32,7 +32,6 @@ 
 	 *
 	 * @access public
 	 * @static
-	 * @param string $key The session name
 	 * @return string The session value
 	 */
 	static public function name($name=null){
@@ -45,7 +44,7 @@ 
 	 * @access public
 	 * @static
 	 * @param mixed $key The variable name
-	 * @return mixed The variable value
+	 * @return string The variable value
 	 */
 	static public function get($key,$default=null){
                 if (($active = static::active()) && isset($_SESSION[$key])) {
@@ -62,7 +61,7 @@ 
 	 *
 	 * @access public
 	 * @static
-	 * @param mixed $key The variable name
+	 * @param string $key The variable name
 	 * @param mixed $value The variable value
 	 * @return void
 	 */
@@ -80,7 +79,7 @@ 
 	 *
 	 * @access public
 	 * @static
-	 * @param mixed $key The variable name
+	 * @param string $key The variable name
 	 * @return void
 	 */
 	static public function delete($key){
@@ -107,7 +106,7 @@ 
 	 *
 	 * @access public
 	 * @static
-	 * @return void
+	 * @return boolean
 	 */
 	static public function active(){
 		return session_status() == PHP_SESSION_ACTIVE;

classes/Route.php

Doc Comments +1 added lines, -2 removed lines

@@ -198,7 +198,6 @@ 
 
     /**
      * Bind a middleware callback to invoked before the route definition
-     * @param  callable $before The callback to be invoked ($this is binded to the route object).
      * @return Route
      */
     public function & before($callback){
@@ -318,7 +317,7 @@ 
      * @param  string  $pattern The URL schema with the named parameters
      * @param  string  $URL The URL to process, if omitted the current request URI will be used.
      * @param  boolean $cut If true don't limit the matching to the whole URL (used for group pattern extraction)
-     * @return array The extracted variables
+     * @return callable The extracted variables
      */
     protected static function extractVariablesFromURL($pattern,$URL=null,$cut=false){
         $URL     = $URL ?: Request::URI();

classes/View.php

Doc Comments +2 added lines, -2 removed lines

@@ -29,7 +29,7 @@ 
 
     /**
      * Load a Template Handler
-     * @param  class $handler The template handler class instance
+     * @param  View\Adapter $handler The template handler class instance
      */
     public static function using(View\Adapter &$handler){
       static::$handler = $handler;
@@ -69,7 +69,7 @@ 
 
     /**
      * Returns the handler instance
-     * @return mixed
+     * @return View\Adapter
      */
     public static function & handler(){
       return static::$handler;

classes/View/PHP.php

Doc Comments +3 added lines

@@ -57,6 +57,9 @@
 class PHPContext {
     protected $data      = [];
 
+    /**
+     * @param string $path
+     */
     public function __construct($data=[], $path=null){
         $this->data = $data;
     }

classes/SQL.php

Doc Comments +5 added lines

@@ -101,6 +101,11 @@
             $queries           = [],
             $last_exec_success = true;
 
+  /**
+   * @param string $dsn
+   * @param string $username
+   * @param string $password
+   */
   public function __construct($dsn, $username=null, $password=null, $options=[]){
     $this->connection = [
       'dsn'        => $dsn,