Vue.js для начинающих, урок 8: компоненты / блог компании ruvds.com / хабр

Не выполняется целостное формирование выходных документов

После того, как плата разработана и сконструирована в соответствии со всеми требованиями и ограничениями, необходимо получить комплект выходных документов для изготовления печатной платы и печатного узла: распечатки схем, файлы Gerber, файлы Pick & Place и т.д.

Altium Designer позволяет формировать такие файлы по отдельности из соответствующих редакторов, но подобный подход сопряжен с проблемами целостности формируемых данных – после получения выходного документа возможно внесение изменений в исходный проект, и если не сформировать этот выходной документ заново, исходные и выходные данные больше не будут соответствовать друг другу.

Кроме того, такой подход является достаточно трудоемким, поскольку для каждого проекта требуется достаточно обширный комплект документов, и их формирование по одному займет много времени.

Эта проблема отчасти решается файлами Output Job, где можно заранее задать настройки всех требуемых выходных документов. Далее эти файлы добавляются в проект, и комплект всех выходных документов можно получить в несколько кликов.

Но наиболее целостный и комплексный подход к формированию выходных данных обеспечивает процесс выпуска проектов с помощью средства Project Releaser. Преимущества этого процесса заключаются в следующем:

Процесс выпуска осуществляется только для самых новых данных проекта, которые должны быть сохранены. После запуска процесса и подготовки к выпуску данных проекта, внесение изменений в проект недопустимо. При внесении изменений в проект, выпуск проекта не будет осуществлен, и его нужно будет запустить заново, для новых данных.
Выпуск проекта основан на файлах Output Job, присутствующих в проекте. Если в эти файлы добавлено формирование отчетов о проверке (таких как проверки ERC, DRC, проверка соответствия посадочных мест на плате компонентам в библиотеке и т.д.). Эти проверки будут выполнены в рамках подготовки данных проекта к выпуску. Если какая-либо из этих проверок не будет выполнена (например, будет найдено нарушение DRC в плате, как показано на изображении ниже), выпуск будет прерван. Будет необходимо исправить соответствующие нарушения в проекте и начать процесс выпуска заново.
Процесс выпуска тесно интегрирован с контролем версий. Если выпуск осуществляется на сервер управляемых данных, проект должен быть зафиксирован на сервере перед подготовкой данных. Таким образом, на компьютере проектировщика не останется каких-либо данных проекта, доступных только ему, поскольку они будут доступны в централизованном хранилище.

Introduction

React Router is a fully-featured client and server-side routing library for React, a JavaScript library for building user interfaces. React Router runs anywhere React runs; on the web, on the server with node.js, and on React Native.

If you’re just getting started with React generally, we recommend you follow the excellent Getting Started guide in the official docs. There is plenty of information there to get you up and running. React Router is compatible with React >= 16.8.

We’ll keep this tutorial quick and to the point. By the end you’ll know the APIs you deal with day-to-day with React Router. After that, you can dig into some of the other docs to get a deeper understanding.

While building a little bookkeeping app we’ll cover:

Configuring Routes
Navigating with Link
Creating Links with active styling
Using Nested Routes for Layout
Navigating programmatically
Using URL params for data loading
Using URL Search params
Creating your own behaviors through composition
Server Rendering

Navigator

Navigator — это еще один Widget, управляющий страницами приложения в формате стека. Полноэкранные страницы называются маршрутами при использовании в Navigator. Navigator работает как реализация обычного стека. К нему прилагаются два хорошо известных метода: и .

Push: Метод push используется для добавления еще одного маршрута на вершину текущего стека. Новая страница отображается поверх предыдущей.
Pop: Поскольку Navigator работает как стек, он использует принцип LIFO (Last-In, First-Out). Метод pop удаляет верхний маршрут из стека, а пользователю отображается предыдущая страница.

В этой статье мы рассмотрим:

Два способа навигации
Передачу данных следующей странице.

Не выполняется настройка отчетов об ошибках соединений

По аналогии с предыдущим пунктом, есть возможность настройки допустимых соединений различных объектов цепей (выводов, портов, входов в лист) в зависимости от их типа. Например, если соединение входного вывода с выходным считается допустимым, то соединение двух выходных выводов или двух входных портов может быть ошибкой.

Для каждой пары объектов может быть настроен уровень отчета на вкладке Connection Matrix диалогового окна Project Options. На ней представлена матрица соединений, по строкам и столбцам которых приведены объекты различных типов, а уровень отчета задается ячейкой на их пересечении. Аналогичным образом, в этой же матрице можно настроить уровень отчета для неподключенных объектов (столбец Unconnected).

Передаём store в RivateRoute

Изменяем

 <PrivateRoute auth={auth} path="/lk" component={ ()=>(<PageLk/>) } />

На

<PrivateRoute store={store} path="/lk" component={ ()=>(<PageLk/>) } />

И идём опять в наш файл с PrivateRoute и переписываем его

import React from 'react';
import { Route, Redirect } from 'react-router-dom';

const PrivateRoute = ({ component: Component, store, ...rest }) => (
  <Route
    {...rest}
    render={props => (
      'auth' in store.getState() && store.getState().auth.isAuthValue === true)
        ? <Component {...props} />
        : <Redirect to="/auth" />
    )}
  />
);

export default PrivateRoute;

Тут через store.getState() мы проверяем есть ли на данный момент ‘auth’ в storе. В начале жизни нашего приложения его может не быть. И ещё мы проверяем наше isAuthValue на true

Use useRoutes instead of react-router-config

All of the functionality from v5’s package has moved into core in v6. If you prefer/need to define your routes as JavaScript objects instead of using React elements, you’re going to love this.

Routes defined in this way follow all of the same semantics as . In fact, is really just a wrapper around .

We encourage you to give both and a shot and decide for yourself which one you prefer to use. Honestly, we like and use them both.

If you had cooked up some of your own logic around data fetching and rendering server-side, we have a low-level function available as well similar to the one we had in react-router-config.

XML или Annotation?

Какой же подход лучше всего подойдет для создания конфигураций на Spring: XML или аннотации? На мой взгляд, это вопрос вкуса:

С одной стороны, практично выносить конфигурации приложения за пределы кода, как это происходит в XML-конфигурации. В таком случае вы избегаете смешения бизнес-логики приложения с его настройкой.
С другой стороны, именно аннотации позволяют наблюдать конфигурацию внутри Java-кода. Так вы сразу увидите, какой класс является компонентом и какие у него существуют зависимости.

В любом случае важно помнить, что конфигурации полностью взаимозаменяемы и не отличаются друг от друга по функционалу. Главное — выбрать один вид конфигурации и придерживаться его во время разработки вашего приложения

Настройка маршрутов в Linux

Вы можете настраивать таблицу маршрутизации с помощью команды ip. Например, чтобы изменить маршрут по умолчанию достаточно выполнить:

Так вы можете добавить маршрут для любого IP адреса, например, для 243.143.5.25:

Все очень просто, сначала указывается IP адрес цели, а затем шлюз в локальной сети, через который можно достичь этого адреса. Но такие маршруты будут активны только до перезагрузки, после перезагрузки компьютера они будут автоматически удалены. Чтобы маршруты сохранились их нужно добавить в файл конфигурации.

В операционных системах семейства Red Hat используются конфигурационные файлы /etc/sysconfig/network-scripts/route-ethX. Каждый файл может описывать несколько маршрутов, например:

Здесь gateway — шлюз по умолчанию для этого интерфейса, netmask — маска сети, а ipaddr — ip адрес интерфейса. В Debian и основанных на нем дистрибутивах можно настроить маршруты в файле /etc/network/interfaces. Здесь команда route добавляется в секцию iface. Например:

С помощью опции -net мы указываем целевую сеть, netmask — это маска сети, а gw — шлюз. Все очень просто. Теперь добавленные маршруты останутся даже после перезагрузки.

Как сделать Deeplink самому?

Если у вас есть базовые знания и , то приступим к делу. Сначала нужно понять логику работы ссылок: пользователь кликает по ссылке, дальше нужно определить с какого устройства был произведен клик , дальше попытаться найти установленное приложение соц сети и если приложение найдено — открыть его, если не найдено, то открыть ссылку в браузере.
От слов к делу. Рассмотрим пример для Instagram. Для остальных социальных сетей делается аналогично.

    <a 
        id="instagam" 
        android-apk="intent://instagram.com/_u/glimake/#Intent;package=com.instagram.android;scheme=https;end" 
        apk="instagram://glimake" 
        href="https://www.instagram.com/glimake/"
        class="item btn btn-action btn-inst deeplink"
    >
        <div class="fa fa-instagram" aria-hidden="true"> </div> Instagram
    </a>

Пройдемся по коду: Открывающийся тег (ссылка), в котором добавлены атрибуты – для удобства, – собственный атрибут для запуска приложения на Android, – собственный атрибут для запуска приложения на iOs, атрибут – где расположена полная ссылка на профиль, атрибут – для задания классов; Тег (блок) – здесь используется для вывода иконки инстаграм; текст ссылки Instagram; закрывающий тег.

    <iframe id="app-frame" src="" style="display: none"></iframe>

Также необходимо в любое место кода между тегами

Вот и весь код на html. Теперь перейдем в JS. Будем использовать не чистый JS, а с подключенной библиотекой JQuery (просто так удобнее).

Код:

    $(function () {
        $(".deeplink").click(function (e) {
          e.preventDefault();
          // Detect device
          var devType = getMobileOperatingSystem();
      
          var android_apk_url = $(this).attr('android-apk');
          var apk_url = $(this).attr('apk');
          var siteUrl = $(this).attr('href');
      
          // alert(url)
          switch (devType) {
            case 'android':
              $('#app-frame').attr('src', android_apk_url);        
              $('#app-frame').ready(function() {
                return;
              });
              setTimeout(function () {
                window.location = siteUrl
              }, 700);
              break;
            default:
              $('#app-frame').attr('src', apk_url);
              $('#app-frame').ready(function() {
                return;
              });
              setTimeout(function () {
                window.location = siteUrl
              }, 700);
              break;
          }
      
          // window.location = url;
          // setTimeout(function () {
          //   window.location = url;
          // }, 500);
        });
      
      });
      var getMobileOperatingSystem = function () {
        var userAgent = navigator.userAgent || navigator.vendor || window.opera;
      
        // Windows Phone must come first because its UA also contains "Android"
        if (/android/i.test(userAgent)) {
          return "android";
        }
      
        // iOS detection from: https://stackoverflow.com/a/9039885/177710
        if (/iPad|iPhone|iPod/.test(userAgent) && !window.MSStream) {
          return "ios";
        }
      
        return "desktop";
      }

Нам понадобится создать дополнительную функцию , которая будет определять устройство (OS) с которого зашли на нашу страничку: desktop, ios, android.

Остается 2 вопроса: 1. Почему в нет условия на desktop; 2. Зачем использовать

POST-метод в роутах (route post) и отправка формы

Теперь предлагаю кратко рассмотреть post-запросы и то, как мы можем обрабатывать их с помощью роутов. Здесь ситуация немного другая, чем с get-запросом, так как всё, что к нам пришло из формы мы будем получать не так, как раньше.

Предположим, что у нас есть форма с одним полем, которая отправляет данные из этого поля методом POST по адресу /setname. Пускай ее предназначение — установить имя пользователя, поэтому передаваемый параметр будет называться name. Давайте взглянем на форму:

Теперь нам нужно прописать роут для ее обработки:

Здесь пока что всё понятно. Вместо метода get мы использовали метод post. Кроме того, мы не передаем никакие параметры в самом URL, а значит переменных в фигурных скобках у нас нет.

А вот и метод для обработки всего этого дела:

Теперь видна большая разница, по сравнению с GET-запросом. Чтобы получить переданные данные из POST-запроса сначала мы получаем экземпляр класса Illuminate\Http\Request под именем $request.

Вставить его таким образом в наш код (как параметр метода) позволяет специальный механизм под названием Dependency Injection, о котором я не буду сейчас говорить, но настоятельно рекомендую почитать самостоятельно.

Как видно из кода, чтобы получить конкретное значение конкретного поля, нужно вызвать $request->get() и передать ему имя параметра, значение которого мы хотим получить.

Каждый проектировщик создает собственную библиотеку компонентов

Электронные компоненты являются основой любой печатной платы, поэтому крайне важно соблюдать корректность и целостность данных о компонентах в библиотеках. К сожалению, крайне распространена практика, когда каждый проектировщик в организации ведет собственную библиотеку компонентов

Это приводит к тому, что используемые библиотеки компонентов не стандартизированы, за этими библиотеками нет контроля, и что, в конечном итоге, приводит к дублированию работы, поскольку одни и те же компоненты создаются множеством инженеров.

Файловые библиотеки компонентов Altium Designer (дискретные библиотеки, интегрированные библиотеки, библиотеки на основе баз данных) можно расположить на общедоступном ресурсе, таком как общая сетевая папка, но это тоже не избавляет от ряда проблем, связанных с ограничениями этих библиотек, например:

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

Для устранения этих и других ограничений, важных с точки зрения совместной работы, Altium предлагает создание и хранение централизованных библиотек компонентов, размещаемых на сервере: облачном Altium 365 Workspace или самоуправляемом (размещаемом в собственной сети предприятия) Altium Concord Pro.

Что такое Route Resource в Laravel?

Это такая штука, которая позволяет нам использовать стандартные пути и названия методов для создания CRUD-форм (Create, Read, Update, Delete). Эти формы всем известны: когда вы создаете, например, товар в админке, вы можете как минимум: создать его (когда его еще нет), отредактировать его (когда он уже был создан) и удалить его (когда он уже существует). В некоторых случаях вы можете посмотреть информацию о нем (Read из слова CRUD). Иногда этот метод отвечает за что-то другое.

В любом случае, «ресурс» позволяет здорово экономить строчки кода и стандартизировать свое приложение. Записывается он следующим образом:

Помните результат вывода команды, которую мы обсуждали несколько выше?

Вот какие роуты создаст метод Route::resource(). По порядку: тип запроса, URI, метод указанного контроллера (тут — PostsController), Имя роута (заданного с помощью метода name()):

Обратите внимание, что в общем-то, он скорее похож на REST API, чем на админку. Потому, что на вход он ожидает PUT и DELETE HTTP-заголовки

Тем не менее, он вполне подходит и для админки.

Еще обращаю ваше внимание на то, что метод create(), который он подразумевает в нашем контроллере — это отображение формы создания, но еще не само создание. А вот метод POST /photos — это как раз создание (то есть отправка заполненной формы из метода create() на сервер)

Аналогично и с редактированием.

Что еще может быть полезно в роутах? Я хотел бы дополнить статью несколькими полезными советами далее.

Remove component prop

no longer supports the prop for overriding the returned anchor tag. There are a few reasons for this.

First of all, a should pretty much always render an . If yours does not, there’s a good chance your app has some serious accessibility and usability problems, and that’s no good. The browsers give us a lot of nice usability features with and we want your users to get those for free!

That being said, maybe your app uses a CSS-in-JS library, or maybe you have a custom, fancy link component already in your design system that you’d like to render instead. The prop may have worked well enough in a world before hooks, but now you can create your very own accessible component with just a few of our hooks:

If you’re using , we provide that works basically the same way. Just call that hook’s returned function in your ‘s handler and you’re all set.

Делитесь с Интернетом

Notion — это быстрый и простой способ создания и редактирования веб-сайта. Опубликуйте свое портфолио, резюме или что-нибудь еще, что вы хотели бы опубликовать в Интернете.

Нажмите в правом верхнем углу страницы.
Включите () и ваша страница сразу же станет общедоступной по уникальному URL!
Все страницы внутри выбранной страницы мгновенно станут общедоступными и будут работать как ссылки.
Щелкните (), чтобы поделиться своей страницей с кем угодно, независимо от того, используют они Notion или нет.

При включении Share to the web появляется еще пара вариантов:
Включите () или (), чтобы разрешить другим пользователям Notion вносить изменения и добавлять комментарии, когда вы делитесь с ними ссылкой.
Отключите параметр (), если вы не хотите, чтобы другие пользователи Notion могли дублировать вашу страницу в своем рабочем пространстве.
Включите (), если вы хотите, чтобы ваша страница проиндексировалась Google и т. д. (Доступно только для платных тарифов)

Разделение кода (code splitting)

{
  "presets": "@babel/preset-react",
  "plugins": "@babel/plugin-syntax-dynamic-import"
}

— это библиотека для загрузки компонентов с помощью динамического импорта. Она значительно облегчает разделения кода за счет автоматической обработки всех крайних случаев.

import loadable from "@loadable/component"
import  from "./Loading.js"

export const LoadableComponent = loadable(() => import("./Dashboard.js"), {
  fallback: < >
})

Это все, что нужно сделать. Просто используйте данный компонент в своем приложении. — это компонент-заместитель на время загрузки настоящего компонента. также может использоваться при рендеринге на стороне сервера.

Какие Deeplink-и для каких социальных сетей?

Приведу небольшой список самых популярных социальных сейте для android и ios:

Whatsapp (вместо звездочек подставляете свой телефон в международном формате без «+»)
Android:
iOS:
Telegram (вместо glimake подставляете свой ник)
Android:
iOS:
Vk (вместо glimake подставляете свой ник)
Android:
iOS:
Facebook (вместо цифр подставляете свой идентификатор)
Android:
iOS:
Youtube (вместо 1k6j01 подставляете свой ник)
Android:
iOS:
Instagram описан в примере выше. (вместо glimake подставляете свой ник)

Для всех остальных соц сетей можете воспользоваться сервисом app.urlgeni.us, который сгенерирует вам готовые ссылки под ios и android.

Если какие-то моменты остались непонятными, пишите в комментарии. По всем вопросам также можете обращаться напрямую. Если есть чем добавить статью, прошу написать также в комменты свое замечание

Спасибо за внимание!

Search Params

Search params are like URL params but they sit in a different position in the URL. Instead of being in the normal URL segments separated by , they are at the end after a . You’ve seen them across the web like or .

React Router makes it easy to read and manipulate the search params with . It works a lot like but stores and sets the state in the URL search params instead of in memory.

Let’s see it in action by adding a little filter on the invoices nav list.

Check this out, as the user types:

is putting the search params in the URL and rerendering the router.
is now returning a with as one of its values.
We set the value of the input to whatever is in the filter search param (it’s just like but in the URLSearchParams instead!)
We filter our list of invoices based on the filter search param.

Жизненный цикл бина: использование @PostConstruct и @PreDestroy

Существует две основные аннотации для внедрения в жизненный цикл. Ими помечается метод, который будет внедрен в жизненный цикл.

— метод будет вызван после конструктора;
— метод будет вызван перед уничтожением бина;

В этих методах удобно инициализировать дополнительные ресурсы или же наоборот — подчищать их после себя. Некоторые методы работают только для , либо только для -компонентов. Если мы используем -компонент, то метод будет вызван только один раз. Однако, совсем неочевидно, что метод невозможно вызвать для -бинов, когда для каждой зависимости создается новый объект.

Без ошибок: аннотация @Qualifier

Если у интерфейса, который внедряется с помощью существует несколько реализаций (, и т.п.), возникнет неопределенность, которая может привести к программной ошибке. Этого можно избежать путем прописывания аннотации . Без добавления аннотации Spring не сможет понять, к какой именно реализации мы хотим обратиться.

@Qualifier

Три компонента одного @Component

У аннотации существует три аналога:

;
;
.

На сегодня эти аннотации функционально ничем друг от друга не отличаются. Их просто можно использовать в качестве маркеров вместо . Но разработчики не гарантируют, что в будущем у них не появятся новые функции. К примеру, уже сейчас получила возможность отлавливать Dao-exceptions для репозиториев.

Если вы не можете ответить на вопрос, для какого конкретно случая вы используете аннотацию из списка выше — просто прописывайте .

Использование роутов в шаблонах (route blade view) или именование роутов (route name)

В самом начале статьи я привел пример именованного роута (route name), но там не объяснил, что именно это значит и зачем это использовать. Пришло время объяснить.

Чтобы было совсем понятно, давайте воспользуемся не тем роутом, а новым, который мы сделали для пользователя и сразу же добавим ему имя:

Как вы уже догадались, чтобы дать роуту имя, нужно применить метод name и в качестве параметра указать строку-название этого роута. Она может быть произвольной, но желательно применять к ней те же правила, что и к переменным.

Теперь представим, что мы пишем blade-шаблон и забыли какой именно URI был прописан в нашем роуте, но мы точно помним его название (name) роута — «profile». Мы легко и быстро можем получить URL по имени роута, не прописывая этот URL «жестко»! Для этого достаточно вызвать следующую функцию-хелпер из шаблона:

И она вернем там не только URL, но и самостоятельно подставит ID пользователя. Причем не куда попало, а именно в то место, где мы задали его в первом параметре для Route::get. В результате мы получим следующий URL:

/user/423

Я настоятельно рекомендую использовать эту функцию. Она крайне полезна в том смысле, что позволяет поменять ссылки на пользователей на всём сайте, изменив только сам роут в web.php. В противном случае поиск всех ссылок и их замена может быть довольно мучительна, когда ваш проект станет достаточно большим.

Настройка

У маршрутизируемого приложения Angular есть только один экземпляр службы . Когда URL-адрес браузера изменяется, то маршрутизатор ищет соответствующий маршрут, благодаря которому будет сопоставлено требуемое представление.

Маршрутизатор не будет содержать маршрутов, до тех пор, пока вы его не настроите. В следующем примере создается пять маршрутов, которые передаются маршрутизатору через метод, и затем это все подключается в AppModule.

Массив маршрутов описывает, как перемещаться в приложении. Передайте массив методу и подключите модуль роутера в imports в AppModule.

Каждый о сопоставляет URL-адрес () с представлением компонента. Свойство путь в роуте не содержит начальных косых черт. Маршрутизатор всегда анализирует маршрут и создает для конечный URL-адрес, что позволяет использовать как относительные, так и абсолютные пути при переходе между представлениями.

Во втором маршруте — это токен, который является частью маршрута. Например, в URL-адресе «42» — это значение параметра . Компонент использует значение id, для того чтобы найти героя, где в данном случае было бы равно 42.

Свойство в третьем маршруте является местом хранения произвольных данных, связанных с конкретным маршрутом. Свойство доступно для любого маршрута. Используйте его для хранения таких элементов, как заголовки страниц, текст хлебных крошек и другие статические данные, доступные только для чтения. Вы можете использовать гуарды для получения динамических данных.

Пустые кавычки в четвертом маршруте представляет собой путь по умолчанию — место, куда нужно перейти, когда путь в URL-адрес пуст. Этот маршрут по умолчанию перенаправляет на маршрут и, следовательно, отображает .

Если вам нужно увидеть, какие события происходят во время жизненного цикла навигации, есть опция . Данная опция выводит каждое событие маршрутизатора в консоль браузера, которое случилось во время жизненного цикла навигации. Используйте только для тестирования и отладки. Для этого, установите параметр , передав его как объект в качестве второго аргумента в методе .

Adding a navigation menu

To navigate at a particular route within the React app, or the two currently existing routes in the demo app, let’s add a minimal navigation bar with the help of the component from .

Begin by importing it from the library:

import { BrowserRouter as Router, Routes, Route, Link } from 'react-router-dom';

The concept of navigating between different web pages in HTML is to use an anchor tag:

<a href="">Some Link Name</a>

Using this approach in a React app is going to lead to refreshing a web page, each time a new view or page itself is rendered. This is not the advantage you are looking for when using a library like React. To avoid the refreshing of the web pages, the library provides the component.

Next, inside the function component, create a nav bar as shown in the code snippet:

<Router>
  <nav style={{ margin: 10 }}>
    <Link to="/" style={{ padding: 5 }}>
      Home
    </Link>
    <Link to="/about" style={{ padding: 5 }}>
      About
    </Link>
  </nav>
  {/* Rest of the code remains same */}
</Router>

Go to the browser window to see the navigation bar in action:

Устранение неполадок компонентов планшетного ПК

В некоторых случаях вы можете столкнуться с проблемами, если вы используете планшетный ПК. Например, элемент настроек моего планшетного ПК на панели управления просто исчез на моем Surface Pro, и я больше не мог калибровать ручку.

В этом случае вы можете попытаться создать новый ярлык для настроек планшетного ПК, щелкнув правой кнопкой мыши на рабочем столе и выбрав новый — кратчайший путь, Для местоположения скопируйте и вставьте следующее:

%windir%explorer.exe shell:::{80F3F1D5-FECA-45F3-BC32-752C152E456E}

Дайте ярлыку подходящее имя, например Настройки планшета а затем нажмите Конец, Теперь вы сможете получить доступ к настройкам планшета. Наслаждайтесь!

Что такое роуты (route) в Laravel?

Если говорить грубо, существует два типа URL’ов (надеюсь, объяснять, что такое URL — не нужно). Абсолютный и относительный. Абсолютный URL включает в себя имя домена, например: https://developernotes.ru/laravel-5. Относительный же имя домена в себя не включает, например: /laravel-5

Относительный URL обычно называется URI. Я объясняю «на пальцах», и за дополнительной информацией очень рекомендую сходить в википедию. Развивает, знаете ли.

Как вы помните, Laravel работает по модели MVC. Модель-представление-контроллер. И route позволяет нам «связать» запрашиваемый адрес и определенный метод контроллера таким образом, чтобы при запрашивании этого адреса вызывался именно этот метод.

То есть отправной точкой у нас является роут. И если не задан ни один, то наше приложение не сможет «начаться».

На самом деле route читается как «рут». Но, видимо, чтобы не путать с именем супер-пользователя в Linux (root) или корнем сайта (root directory), на русском языке его называют обычно «роут». А может быть просто по незнанию. Безграмотные ублюдки. Зато понятно!

Давайте напишем свой первый роут, который обрабатывал бы обращение к главной странице сайта.

Создайте любой контроллер, который вы хотите. Я обычно называю его IndexController. И создайте в нем метод index() следующим образом:

После чего откройте файл routes/web.php (предполагается, что в этом файле хранятся все роуты, относящиеся к браузеру; могут быть и другие). Удалите всё, что в нем есть (для чистоты эксперимента) и напишите строчку:

Откройте сайт и — вуаля! Мы видим слова «Роут работает», нам чем наш Laravel закономерно завершил работу.

Итак, что мы сделали? За всё здесь отвечает класс Route. Мы обратились к статическому методу get этого класса. В данном случае «get» — это в смысле «GET-запрос», а не «получить данные». То есть в данном случае мы обрабатываем именно get-запрос. Например, если мы хотим обработать POST-запрос, мы должны написать Route::post(…).

На самом деле, мы можем обработать довольно много разных типов HTTP-запросов, которые обычно используются в RESTfull API, такие как: put, delete, patch и другие, но это тема отдельной статьи.

Route имеет метод any (Route::any(…)). В этом случае он обработает запрос любого типа с казанным URI. Но я настоятельно не рекомендую пользоваться такой возможностью. Если вы так делаете, скорее всего вы не знаете — зачем. И это может повлечь ошибки, которые сразу можно и не предусмотреть.

Первым обязательным параметром является непосредственно URI

Обратите внимание, что для корневой страницы мы использовали значение /. То есть слеш без каких-либо параметров

Такой URI может быть только у корневой (индексной, главной) страницы сайта, ни у какой другой.

Вторым параметром мы передали название контроллера и метода в нем, куда Laravel должен передать управление. Название контроллера и метод в нем записывается через символ собаки (@). В принципе, ловко придумано. Сначала контроллер, потом собака, потом название метода. В нашем случае строка «IndexController@index» означает, что нужно обратиться к контроллеру IndexController и методу index внутри него.

Что такое name() я покажу чуть позже, не переживайте. Если в двух словах — эта функция используется для «именования» роута и для удобства программиста. В дальшейшем можно будет вызвать роут по этому имени внутри какого-нибудь blade-шаблона, а в качестве вернувшегося значения получить URI, который мы вписали в этот роут. Это нужно, например, на случай, если вы поменяли URI в web.php, но забыли поменять его где-то в шаблонах.