y_

Authentication, http requests, internationalization, updating data and logging the changes... all those functions you need to rewrite each time you want to prototype a php application!

y_ handles these functions and lets you focus on important things.

• light: y_ is only a few functions which all get loaded, you don't need to declare them separately
• basic: y_ is not object-oriented and doesn't support sql, all data is handled in .json
• unobtrusive: y_ doesn't get in your way, you only use what you see fit, functions and variables are prefixed with y_

Available functions:

y_dbload()

• depends on: none
• arguments:
  • string $arg db name inclusive filepath, without .json
• globals: $y_feedback

function y_dbload($arg){
   global $y_feedback;
   $dbfullpath=$arg.'.json';
   if(is_file($dbfullpath)){
      $res=json_decode(file_get_contents($dbfullpath),true);
      return $res;
   }else{
      $y_feedback[]='base de données pas trouvée';
      return $y_feedback;
   }
}

y_auth()

• depends on: y_dbload()
• arguments:
  • boolean $parameter to log in or out
  • string $type (optional) pw or token
  • array $request (optional) consisting of ['user'] the username or email entered by the user, ['pw'] the password entered by the user
• globals: $y_feedback, $y_var

y_i18n() +

• depends on: y_dbload()
• arguments:
  • string $words text description
• globals: $lang

if ($_REQUEST['lang']!=null) {$lang=$_REQUEST['lang'];} else {$lang='';}
function y_i18n($words){
   $langdir='lang/';
   global $lang;
   if (!is_file($langdir.$lang.'.txt')){
      $lang='fr';
   }
   $lang_array=json_decode(file_get_contents($langdir.$lang.'.txt'),true);
   foreach($lang_array as $k=>$v){
      if ($k==$words){
         return $v;
      }
   }
}

y_array_read()

• to: read an array element according to an inner path
• depends on: none
• arguments:
  • array $table (multidimensional safe)
  • array $path, null if the full array $table is expected as result
• returns: string or array

function y_array_read(array $table,array $path){
   global $path_index, $result;
   if($path[0]==null){
      $result=$table;
   }else{
      $path_current=array_shift($path);
      if ($path!=null){
         y_array_read($table[$path_current],$path);
      }else{
         $result=$table[$path_current];
      }
   }
   return $result;
}

y_array_write()

• to: update an array element according to an inner path
• depends on: none
• arguments:
  • array $table is the original table (multidimensional safe)
  • array $path through the table
  • string or array $value is the new variable to write
• returns: array - the updated table

function y_array_write_inner(array $path, $value){
   $result=array();
   $path_current=array_shift($path);
   if ($path!=null){
      $result[$path_current]=y_array_write_inner($path, $value);
   }else{
      $result[$path_current]=$value;
   }
   return $result;
}
function y_array_write(array $table, array $path, $value){
   return array_replace_recursive($table, y_array_write_inner($path,$value));
}

y_dbcrud()

• to: create, update or delete a db element (in fact always update) and log the change
• depends on: y_dbload(), y_array_read(), y_array_write()
• arguments:
  • string $db db name inclusive filepath, without .json
  • array $scope the inner path within the db file
  • string or array $to the new data
• globals: $y_user, $y_var

function y_dbcrud(string $db, array $scope, $to){
   global $y_user, $y_var;
   $db_data=y_dbload($db);	
   if(is_array($db_data)){
      file_put_contents($db.'.json',json_encode(
         y_array_write($db_data,$scope,$to)
      ));
      $log_temp=y_dbload($y_var['log_db_path']);	
      if(is_array($log_temp)){
         $from=y_array_read($db_data,$scope);
         $log_temp[]=array(
            'date'=>date('Y-m-d H:i:s'),
            'user'=>$y_user,
            'db'=>$db,
            'scope'=>$scope,
            'from'=>$from,
            'to'=>$to
         );
         file_put_contents($y_var['log_db_path'].'.json',json_encode($log_temp));
         unset($log_temp);
      }
      unset($db_data);
   }
}

y_request() + request.json

• depends on: y_dbload()
• arguments:
  • string $name request name
• globals: none

Available variables:

• array $y_feedback
• array $y_var

Get started:

• write on each page: require('y_lib/config.php');
• "db" is meant for .json files, their filepaths are called $XX_db_path, the loaded data $XX_db_data