simple mvc engine

В папке /controller создаём файл контроллера, например mainController.php шаблон есть в файле def.php

Создаём нужный нам метод, например index()

public function index() {
  //Тут мы что то выполняем например можем показать какой то вид View('home')
  return View('home');
}

Для получения данных от клиента используется класс request или хелперrequest()

Получаем переменную из маршрута:

request()->route('id');

Или

route::get('/catalog/item/{id}',function($id) {
  //В переменной $id будет первая переменная из маршрута

Получаем переменную из формы:

request()->input('name');

В папке /app/view создаём файл вида, например home.php

Передать переменную в вид из контроллера или замыкания маршрута

View('home',['message'=>'hello','message2'=>'world']);

В видах мы можем делать как и обычные вставки php <?php ?> так и компилируемые с помощью спецсимволов {{Переменная или функция}} или @функция

<h1>Hello World!!!</h1>
<strong>yes {{$message}} {{$message2}}!</strong>
Time: {{date('H:i:s')}}

Наследование lay - папка, html - файл

@extends('lay.html')

Обьявить секцию

@section('content')  
<div>Контент</div> 
@endsection

или

@section('head','Текст')

Получить секцию

@yield('content')

Обьявить переменную:

@php  
$var = 123; 
@endphp

Перебрать массив

<ul>
@foreach($items as $item)
<li>{{$item}}</li>
@endforeach
</ul>

Добавление собственных функций в компилятор

В файле appService.php в методе register или же подключить свой класс через appService

compiler::declare(имя функции,анонимная функция(агрументы переданные в функцию,последним всегда будет анонимная функция для добавления в конец буффера))

compiler::declare('plus',function($arg1,$arg2,$appendFnc){ 
  $appendFnc('<?php echo '.$arg1.'; ?>');
  return "<?php echo ".($arg1+$arg2)."; ?>";
});

Готово, вызываем в виде

@plus(2,4)

Результат, в том месте где была вызвана функция будет выведено 6

в самом низу страницы будет выведено 2

Compressor - инструмент для обьединения подключаемых css или js файлов в один

Просто передаём компрессору наши файлы в виде массива и указываем какой файл должен получиться

Пример с css

<link href="{{compressor(['css/style.css', 'css/style2.css'], 'styles.css')}}" rel="stylesheet">

В результате получаем всего один файл что положительно сказывается на скорости загрузки страницы

Если содержимое файлов отлично от text/javascript или text/css можем указать своё в 3 агрументе функции

В папке /app/model создаём файл модели, например db.php шаблон есть в файле def.php

По умолчанию имя таблицы должно быть таким же как и название класса модели, но можно переназначить с помощью свойства класса $table

protected $table='other_table';

Для работы с моделью нужно подключить её в контроллере

public function index() {
$this->model("db");
...

Или если нужно использовать в замыкании маршрута

controller::model("db");

Чтобы обратится к модели используем тот же метод только без аргументов: model()->имя модели:

$db = $this->model()->db;

Так же можно обратится к модели сразу после подключения

controller::model("db")->find(1)->delete()

Для работы с данными используется цепочка методов родительского класса:

$db->select('name')->where('id',1)->first();

Примеры:

Получаем массив:

$db->select('name','test','status')->where('uid',1)->get();

Создаём запись:

$db->name = 'name';
$db->price = '123';
$db->save();

Редактируем запись (метод find() используется для получения записи по ID):

$db->find(1);
$db->name = 'name2';
$db->price = '1234';
$db->save();

Удаление записи:

$db->find(1);
$db->delete();

Класс для работы с хранилищем (в стадии разработки)

Сохранить файл на диск

storage::disk('local')->put('file.txt','какие то данные');

Получить файл с диска

storage::disk('local')->get('file.txt');

Удалить файл

storage::disk('local')->delete('file.txt');

Проверить существует ли файл

storage::disk('local')->exists('file.txt');

Так же можно сохранять файлы сразу из при их получении из формы

...
<input type="file" name="file" />
<input type="text" name="fileName" value="default"/>
...

request()->file('file')->storeAs('',request()->input('fileName').'.jpg');

В кэше можно хранить любые данные и файлы от одной секунды до бесконечности

Сохранить данные в кэше put(ключ,данные,время хранения в секундах)

cache::put('message','Hello World!',60);

Получить данные

cache::get('message');

или получить и сразу удалить

cache::pull('message');

Удалить

cache::forget('message');

Проверить сущеутвование по ключу

cache::has('message');

Простой GET запрос

$response = http::get('http://url');

В ответ получаем обьект:

$response->body(); //Тело ответа
$response->json(); //Если запрашивали json можно сразу преобразовать в массив
$response->header('имя заголовка'); //Получить заголовок из ответа
$response->headers(); //Получить все заголовки в виде массива
$response->ok(); //Если всё хорошо то true
$response->successful(); //Если код от 200 до 299
$response->failed(); //Если код от 400 до 499
$response->clientError(); //Если код 400
$response->serverError(); //Если код 500

POST запрос с параметрами

http::post('http://url',['name'=>'value']);

По умолчанию запрос выполняется в виде json обьекта с типом application/json

Если нужно выполнить обычный application/x-www-form-urlencoded то добавьте метод asForm перед выполнением запроса

http::asForm()->post('http://url',['name'=>'value']);

Если нужен multipart/form-data

http::asMultipart()->post('http://url',['name'=>'value']);

Basic авторизация

http::withBasicAuth('user', 'password')->get('http://url');

или Digest авторизация

http::withDigestAuth('user', 'password')->get('http://url');

если Realm статичен, можем указать

http::withDigestAuth('user', 'password')->withRealm('realm')->get('http://url');

Таймаут в секундах

http::timeout('20')->get('http://url');

Вызвать исключение в случае ошибки

http::post('http://url',['name'=>'value'])->throw();

Если нужно обработать ошибку, можно использовать замыкание

http::post('http://url',['name'=>'value'])->throw(function($response, $error){
  die("ой, что-то пошло не так");
});

Обьявить исключение можно в appService.php

exceptions::declare('имя_исключения',function($data=""){
  return response('что то сломалось '.$data);
});

Вызываем исключение

exceptions::throw('имя_исключения', 'Обновите страницу');

Или через хелпер

abort('имя_исключения');

Так же мы можем переназначать системные исключения

Например переназначим исключение валидации на вывод json

exceptions::declare('validate',function($errors){
  return response()->json([
          'status'=>false,
          'errors'=>$errors
   ]);
});

Логирование

Включить логирование можно в файле конфигурации .env

...
#   Logs
LOG_ENABLED=true
...

По умолчанию лог сохраняется по пути ROOT/storage/.log/

Сохранить информацию в лог

log::info('Какой то вывод');

Если нужно записать ошибку используется метод error

log::error('Ошибка');

Лог так же выводится в консольных командах

Например если мы хотим вывести таймер или что то подобное можно использовать метод thisLine в этом случае информация не запишется в файл а будет перезаписываться на этой же строке в консоле

log::thisLine(true)->info(date('s'));

Команды

Запустить Dev server

php console serve

Очистить кэш

php console cache:clear

Запуск приложения из консоли

Например напишем отображение времени в консоли

В файле route/console.php создаём маршрут с методом console с замыканием

route::console('time',function(){
  while(true) { //Создаём вечный цикл
    log::thisLine(true)->info(date('H:i:s')); //Выводим текущее время и смещаем каретку в начало
    sleep(1); //Ставим задержку на выполнение в 1 секунду
  }
});

Запускаем в консоли

php console time

Передача аргументов из консоли

route::console('hello:{arg1}',function($arg1){
  log::info('Hello '.$arg1);
  //или
  log::info('Hello '.request()->route('arg1'));
...

Выполняем

php console hello:world