Переменные

​
Основное использование
Переменные, определенные в Fat-Free, являются глобальными, то есть они могут быть доступны любому компоненту. Глобалы фреймворка не идентичны глобалам PHP. Переменная F3 с именем contentне идентична PHP $content. F3 сам по себе является доменным языком и поддерживает свою собственную отдельную таблицу символов для системных и прикладных переменных. Фреймворк, как и любая хорошо разработанная объектно-ориентированная программа, не загрязняет глобальное пространство имен PHP константами, переменными, функциями или классами, которые могут конфликтовать с любым приложением. В отличие 
от других фреймворков, F3 не использует PHP define() заявление. Все константы фреймворка ограничены классами.
Чтобы присвоить значение F3 переменной:
$f3->set('var',value)
Примечание: F3 переменные принимают все типы данных PHP, включая объекты и анонимные функции.
Чтобы задать сразу несколько переменных:
$f3->mset(
    array(
        'foo'=>'bar',
        'baz'=>123
    )
);
Чтобы получить значение переменной фреймворка с именемvar:
$f3->get('var')
Чтобы удалить F3 переменную из памяти, если она вам больше не нужна (отбросьте ее, чтобы она не мешала другим вашим функциям / методам), используйте этот метод:
$f3->clear('var')
Чтобы узнать, была ли переменная определена ранее:
$f3->exists('var')
Глобальные
F3 поддерживает свою собственную таблицу символов для переменных фреймворка 
и приложения, которые не зависят от PHP. некоторые переменные сопоставляются с глобалами PHP. В F3 SESSION- это эквивалент$_SESSION, а REQUESTкарты$_REQUEST-нет . Рекомендуется использовать переменные фреймворка, а не PHP, чтобы помочь вам с передачей данных между различными функциями, классами и методами. У них есть и другие преимущества:
Переменные фреймворка можно использовать непосредственно в шаблонах.
Вам не нужно указывать PHP ссылаться на переменную вне текущей области видимости, используя глобальное ключевое слово внутри каждой функции или метода. Все переменные F3 являются глобальными для вашего приложения.
Установка F3 эквивалента PHP SESSIONтакже изменяет базовую версию PHP $_SESSION. Изменение последнего также изменяет аналог фреймворка.
Fat-Free не поддерживает просто тупое хранилище переменных и их значений. Он также может автоматизировать управление сеансами и другие вещи. Назначение или извлечение значения через SESSIONпеременную F3 автоматически запускает сеанс. Если вы используете $_SESSION(или связанные с сеансом функции) непосредственно, а не переменную фреймворкаSESSION, ваше приложение становится ответственным за управление сеансами.
As a rule, framework variables do not persist between HTTP requests. Only SESSION and COOKIE  (и их элементы), которые сопоставлены с PHP $_SESSION и $_COOKIE глобальные переменные не зависят от состояния HTTP.
Существует несколько предопределенных глобальных переменных, используемых внутри Fat-Free, и вы, безусловно, можете использовать их в своем приложении. Будьте уверены, что вы знаете, что делаете. Изменение некоторых глобальных переменных без жира может привести к неожиданному поведению фреймворка.
Платформа содержит несколько переменных, которые помогут вам упорядочить структуру файлов и каталогов. Мы видели, как мы можем автоматизировать загрузку классов с помощью автоматической AUTOLOAD. Существует глобальная переменная UI пользовательского интерфейса, которая содержит путь, указывающий на расположение ваших HTML-представлений/шаблонов. DEBUG- это еще одна переменная, которую вы будете довольно часто использовать во время разработки приложений, и она используется для настройки детализации следов ошибок.
Полный список встроенных переменных фреймворка приведен в Кратком справочнике.
Правила Именования
Переменная фреймворка может содержать любое количество букв, цифр и символов подчеркивания. Он должен начинаться с Альфа-символа и не должен содержать пробелов. Имена переменных чувствительны к регистру.
F3 использует все заглавные буквы для внутренних предопределенных глобальных переменных. Ничто не мешает вам использовать имена переменных, состоящие из всех заглавных букв 
в вашей собственной программе, но, как правило, придерживайтесь нижнего регистра (или camelCase) при настройке собственных переменных, чтобы избежать любого возможного конфликта с текущими и будущими выпусками фреймворка.
Вы не должны использовать зарезервированные PHP слова, такие какif, for, class, и т.д.default как имена переменных фреймворка. Это может привести к непредсказуемым результатам.
Работа со строковыми и массивными переменными
F3 также предоставляет ряд инструментов, которые помогут вам работать с переменными фреймворка.
$f3->set('a','fire');
$f3->concat('a','cracker');
echo $f3->get('a'); // возвращает строку 'firecracker'
​
$f3->copy('a','b');
echo $f3->get('b'); // возвращает ту же строку: 'firecracker'
F3 также предоставляет некоторые примитивные методы для работы с переменными массива:
$f3->set('colors',array('red','blue','yellow'));
$f3->push('colors','green'); // работает как PHP array_push()
echo $f3->pop('colors');     // возвращается 'green'
​
$f3->unshift('colors','purple'); // похоже на array_unshift()
echo $f3->shift('colors');       // возвращается 'purple'
​
$f3->set('grays',array('light','dark'));
$result=$f3->merge('colors','grays'); // объединяет два массива
Структуры Каталогов - Сделай сам!
В отличие от других фреймворков, которые имеют жесткую структуру папок, F3 дает вам большую гибкость. У вас может быть структура папок, которая выглядит следующим образом (заключенные в скобки слова во всех заглавных буквах представляют переменные фреймворка F3, которые нуждаются в настройке):
/ веб-корень, где находится index.php
    app/ файлы приложений
        dict/ ЛОКАЛИ, необязательно
        controllers/
        logs/ ЛОГИ, необязательно
        models/
        views/ UI
    css/
    js/
    lib/ вы можете хранить base.php здесь
    tmp/ 
        cache/ 
Не стесняйтесь организовывать свои файлы и каталоги так, как вы хотите. Просто установите соответствующие глобальные переменные F3. Если вы хотите действительно безопасный сайт, Fat-Free даже позволяет хранить все ваши файлы в недоступном для Интернета каталоге. Единственное требование состоит в том , чтобы вы оставили index.php, .htaccess и свои публичные файлы, такие как CSS, JavaScript, изображения и т. д. в пути, видимом вашему браузеру.
Об обработчике ошибок F3
Fat-Free генерирует свои собственные HTML-страницы ошибок с трассировками стека, чтобы помочь вам в отладке. Вот вам пример:
внутренняя ошибка сервера
strpos () ожидает по крайней мере 2 параметра, 0 задано
• var/html/dev/main.php:96 strpos()
• var/html/dev/index.php:16 Base->run()
Если вы чувствуете, что это слишком просто или хотите сделать что-то другое, когда возникает ошибка, вы можете создать свой собственный обработчик ошибок:
$f3->set('ONERROR',
    function($f3) {
        // код пользовательского обработчика ошибок находится здесь
        // используйте это, если вы хотите отобразить ошибки в
        // формат соответствует теме вашего сайта
        echo $f3->get('ERROR.text');
    }
);
F3 поддерживает глобальную переменную, содержащую сведения о последней ошибке, возникшей в вашем приложении. ERRORПеременная представляет собой массив, структурированный следующим образом:
`ERROR.code` - код ошибки состояния HTTP (`404`, `500`, etc.)
`ERROR.status` - краткое описание кода состояния HTTP. например, `Не найдено"
`ERROR.text` - контекст ошибки
`ERROR.trace` - трассировка стека, хранящаяся в `array()`
`ERROR.level` - уровень отчетности об ошибках (`E_WARNING`, `E_STRICT`, etc.)
Если ваш проект использует шаблоны, вы можете обработать потенциальные ошибки шаблонов, очистив любой существующий выходной буфер и отобразив вместо него новую страницу:
$f3->set('ONERROR',
    function($f3) {
	// рекурсивно очистите существующие выходные буферы:
        while (ob_get_level())
            ob_end_clean();
        // ваша свежая страница здесь:
        echo $f3->get('ERROR.text');
    }
);
При разработке приложения лучше всего установить максимальный уровень отладки, чтобы можно было проследить все ошибки до их первопричины:
$f3->set('DEBUG',3);
Просто вставьте команду в последовательность начальной загрузки вашего приложения.
Как только ваше приложение будет готово к выпуску, просто удалите инструкцию из вашего приложения или замените ее на:
$f3->set('DEBUG',0);
Это приведет к подавлению вывода трассировки стека на любой сгенерированной системой HTML-странице ошибок (потому что она не предназначена для просмотра посетителями вашего сайта).
DEBUG может иметь значения в диапазоне от 0(stack trace suppressed) до 3(most verbose with class and function call logs).
Не забывай! Трассировки стека могут содержать пути, имена файлов, команды базы данных, имена пользователей и пароли. Вы можете подвергнуть свой веб-сайт ненужным рискам безопасности, если не установите DEBUGглобальную переменную 0в рабочей среде.
Можно настроить описание ошибки в момент запуска ошибки, передав новое описание в качестве второго аргумента, например :
$f3->error(401, "В запросе отсутствует информация, необходимая для предоставления доступа.");
конфигурационный файл
Если ваше приложение должно быть настроено пользователем, F3 предоставляет удобный метод чтения конфигурационных файлов для настройки вашего приложения. Таким образом, вы и ваши пользователи можете настроить приложение, не изменяя никакого PHP-кода.
Существует 4 предопределенных названия разделов:
[globals] для определения глобальных переменных
[routes] для определения маршрутов
[maps] для определения карт маршрутов
[redirects] для перенаправления маршрутов
NB: [globals]предполагается, если раздел не был предоставлен. Вы можете объединить все разделы в один конфигурационный файл-хотя наличие [routes], [maps], и [redirects]в отдельном файле рекомендуется. Таким образом, вы можете разрешить конечным пользователям изменять некоторые флаги конкретных приложений и в то же время запретить им вмешиваться в вашу логику маршрутизации.
Вот как использовать различные разделы:.
[глобальный]
Вместо того чтобы создавать PHP скрипт содержащий следующий пример кода:
$f3->set('num',123);
$f3->set('str','abc');
$f3->set('hash',array('x'=>1,'y'=>2,'z'=>3));
$f3->set('items',array(7,8,9));
$f3->set('mix',array('this',123.45,FALSE));
Вы можете создать конфигурационный файл, который делает то же самое:
[globals]
num=123
; это обычная строка
str=abc
; другой способ присвоения строк
str="abc"
; это массив
hash[x]=1
hash[y]=2
hash[z]=3
; также распознается точечная нотация
hash.x=1
hash.y=2
hash.z=3
; это также массив
items=7,8,9
; массив со смешанными элементами
mix="this",123.45,FALSE
Вместо длинных $f3->set()инструкций в коде вы можете поручить фреймворку загрузить конфигурационный файл в качестве замены кода. Давайте сохраним приведенный выше текст в качестве настройки setup.cfg. Тогда мы можем назвать его простым:
$f3->config('setup.cfg');
Строковые значения не должны заключаться в кавычки, если только вы не хотите включить начальные или конечные пробелы. Если запятая должна рассматриваться как часть строки, заключите ее в двойные кавычки - в противном случае значение будет рассматриваться как массив (запятая используется в качестве разделителя элементов массива). Строки могут охватывать несколько строк:
[globals]
str="это \
очень длинная \
строка"
[пути сообщения]
F3 также дает вам возможность определять маршруты HTTP в конфигурационных файлах:
[routes]
GET /=home
GET /404=App->page404
GET /page/@num=Page->controller
; Кэшируйте маршрут в течение 10 минут
GET /contact=App->contact, 600
; названный маршрут
GET @about: /about=Page->about
[карты]
Карты маршрутов также можно определить в конфигурационных файлах:
[maps]
/blog=Blog\Login
/blog/@controller=Blog\@controller
[перенаправляет]
Вы также можете перенаправлять устаревшие маршруты на новые страницы в конфигурационных файлах:
[redirects]
GET|HEAD /obsoletepage = /newpage
GET|HEAD /dash = @dashboard
GET|HEAD /search = https://www.google.com
[конфигурации]
Вы также можете включить другие конфигурационные файлы.
[configs]
app/routes.ini = true
app/app_ext.ini = false
Не позволяйте правильному значению сбить вас с толку, оба файла выше включены. Параметр true/false boolean запускает $allowаргумент метода config, который позволяет разрешить динамический токен в ваших конфигурационных файлах.
Пользовательский раздел
Любое другое название раздела, кроме 3 выше, интерпретируется как [globals]раздел с префиксом имени раздела.
Итак следующее:
[foo]
a = 1
b = 2
​
[foo.hash]
x = 1
y = 2
z = 3
эквивалентно:
$f3->set('foo',array(
  'a' => 1,
  'b' => 2,
  'hash' => array(
    'x' => 1,
    'y' => 2,
    'z' => 3
  )
));
Секционные Крючки
Кроме того, можно определить пользовательский обратный вызов, который применяется к каждому значению:
[foo.bar:strtoupper]
x = hello
y = world
Учебник - Previous
Маршрутизация
Next - Учебник
Виды и шаблоны
Last modified 1yr ago
Copy link
Outline
Основное использование
Глобальные
Правила Именования
Работа со строковыми и массивными переменными
Структуры Каталогов - Сделай сам!
Об обработчике ошибок F3
конфигурационный файл