Поиск сообщества

Фреймворк Invision Community предоставляет мощный вспомогательный класс для работы с URL-адресами, включая парсинг адресов и создание запросов (так же чтение ответов) URL-адресов. Программное обеспечение автоматически использует cURL, если доступно, и обратно возвращается к стандартным сокетам (это поведение также может быть переопределено константами, если среда хочет принудительно использовать cURL или сокеты). Работа с URL-адресами Класс \IPS\Http\Url используется для работы с URL-адресами, а два вспомогательных метода образуют основной интерфейс для создания объекта URL с этим классом: internal(): Используйте этот метод при создании внутреннего URL-адреса, например URL-адрес форума или темы. Этот метод автоматически создаёт дружественные URL-адреса, если необходимо. external(): Передайте полный URL-адрес этому методу для создания объекта URL-адреса из строки URL-адреса. // Создание URL-адреса на тему с ID = 1 $url = \IPS\Http\Url::internal( 'app=forums&module=forums&controller=topic&id=1', 'front', 'forums_topic', array( 'topic-friendly-slug' ) ); $url = \IPS\Http\Url::external( 'https://www.google.com' ); // Создание объекта URL для стандартной строки URL Внутренний метод принимает следующие параметры: Строка запроса URL-адреса. 'база' ('front' или 'admin', в зависимости от того, является ли URL-адрес на страницу админцентра или нет). SEO шаблон, если применимо. Массив SEO слагов, если шаблон их вызывает. Константу PROTOCOL_* из класса \IPS\Http\Url для переопределения должен ли быть сгенерирован http или https URL-адрес. Вы можете опустить этот параметр и позволить программному обеспечению правильно определить протокол, который будет использоваться автоматически. Внешний метод просто принимает строку URL-адреса. Если вы не уверены, что объект URL, который вы создаете, является внутренним или внешним, вы можете альтернативно использовать метод createFromString() (передавая полный URL-адрес так же, как и с помощью метода external()), однако обратите внимание, что этот метод является ресурсоёмким по производительности и предпочтительны непосредственно методы internal() и external(). Первым параметром для этого метода является URL-адрес, второй параметр - логический флаг, указывающий, может ли URL-адрес являться дружественным внутренним URL-адресом, а третий и последний параметр - логическим флагом, указывающим, хотите ли вы автоматически кодировать любые недопустимые компоненты вместо того, чтобы бросать ошибку (по умолчанию FALSE - установите значение TRUE, если URL-адрес предоставлен пользователем и не должен выдавать ошибку). Вы можете внести корректировки в URL-адрес после создания объекта URL-адреса, вызвав различные методы. setScheme(): Вы можете передать схему в (то есть http или https), или передать в NULL для использования относительной схемы (то есть без схемы вовсе). setHost(): Принимает полное имя хоста. setPath(): Принимает полный допустимый путь. setQueryString(): Принимает ключ строки запроса в качестве первого параметра и его значение как второй параметр ИЛИ массив пар ключ => значение в качестве первого параметра. setFragment(): Принимает фрагмент. stripQueryString(): Принимает ключ строки запроса или массив ключей скроки запроса и удаляет эти параметры строки запроса (если есть) из URL-адреса. Когда вы хотите вывести URL-адрес, вы можете использовать объект \IPS\Http\Url как строку: print (string) $urlObject; Класс имеет несколько дополнительных свойств и методов, на которые вы, возможно, захотите ссылаться или вызывать, описанные ниже: isInternal: свойство указывает, является ли URL-адрес внутренним или нет. isFriendly: свойство указывает, является ли URL-адрес дружественным (внутренним) URL-адресом или нет. queryString: свойство является массивом ключ => значение параметров строки запроса в URL-адресе. hiddenQueryString: свойство является массивом ключ => значение параметров строки запроса, которые были бы, если URL-адрес не был дружественным URL-адресом. Например, если вы создаете внутренний дружественный объект URL, это свойство будет содержать связанные параметры строки запроса, которые не отображаются (поскольку используется дружественный URL-адрес). csrf(): Вызовите этот метод, чтобы добавить ключ CSRF текущего пользователя в URL-адрес как аргумент строки запроса. Затем это будет проверено контроллерами для предотвращения атак типа CSRF. Если у вас есть запрос на изменение состояния, который не использует класс \IPS\Helpers\Form, обычно должны проверять ключ CSRF. (static) seoTitle(): Вы можете вызвать этот метод, чтобы создать допустимый дружественный URL слаг. Обычно это используется, когда контент уже добавлен и URL слаг сохранён для следующего обращения, однако вы можете также вызывать этот метод «на лету», если это необходимо. Создание запросов Создав объект класса \IPS\Http\Url, вы можете делать запросы к нему. Для этого вызывается метод request(). /** * Make a HTTP Request * * @param int|null $timeout Timeout * @param string $httpVersion HTTP Version * @param bool|int $followRedirects Automatically follow redirects? If a number is provided, will follow up to that number of redirects * @return \IPS\Http\Request */ public function request( $timeout=null, $httpVersion=null, $followRedirects=5 ) Он возвращает объект \IPS\Http\Request. Ниже приведены некоторые методы, которые вы можете вызвать перед выполнением запроса: login(): Принимает имя пользователя в качестве первого параметра и пароль в качестве второго параметра и выполняет основной запрос авторизации по URL. setHeaders(): Принимает массив пар ключ => значение заголовков, которые должны быть включены в запрос. sslCheck(): Принимает логическое значение true или false как единственный параметр, сигнализирующий, должны ли проверяться SSL сертификаты или нет. В большинстве случаев это должно быть оставлено по умолчанию (true), если только вы не знаете, что SSL URL-адрес, к которому вы делаете запрос, имеет недопустимый сертификат. forceTls(): Обязать TLS для запроса. Это прежде всего используется с некоторыми платежными шлюзами, которые обеспечивают выполнение запросов TLS. Впоследствии вы можете сделать запрос. Для этого вы вызываете метод запроса, который хотите выполнить (например для выполнения GET запроса, нужно вызвать метод get(), для PUT запроса соответственно put()), передавая любые параметры, которые должны быть включены в запрос (для запросов POST и PUT). $request = \IPS\Http\Url::external( "http://someurl.com" )->request()->get(); Это возвращает объект \IPS\Http\Response, который вы можете теперь проверять и манипулировать по мере необходимости. Во-первых, есть несколько полезных свойств, которые вам могут потребоваться: httpResponseVersion: Версия протокола HTTP запроса (1.0 или 1.1, обычно). httpResponseCode: Код ответа HTTP. Возможно, вам потребуется проверить, что после запроса был возвращен действительный код ответа (т.е. 200). httpResponseText: Это текст ответа HTTP. Например, для запроса 200 это будет "ОК". httpHeaders: Массив, содержащий все HTTP заголовки ответа в виде пар ключ => значение. cookies: Массив всех заголовков Set-Cookie в виде пар ключ => значение. content: Тело ответа. Отправка ответа в виде строки возвращает свойство содержимого, указанное выше. В классе \IPS\Http\Response есть несколько методов, которые можно использовать, чтобы упростить работу с некоторыми распространенными ответами. decodeJson(): Вызов этого метода запустит ответ через json_decode перед его возвратом. Если ответ не в формате JSON, будет выброшено исключение RuntimeException. decodeXml(): Вызов этого метода спарсит ответ как XML, если ответ не в формате XML, будет выброшено исключение RuntimeException. Кроме того, стоит отметить, что если запрос по какой-либо причине даёт сбой (например, тайм-аут подключения к удалённому серверу), выбрасывается исключение \IPS\Http\Request\Exception. С этой целью вы должны оборачивать запросы в блоки try/catch. // Create a URL object $url = \IPS\Http\Url::external( "http://someurl.com" )->setQueryString( 'key', 'value' ); // Построение и декодирование с помощью JSON try { $response = $url->request()->get()->decodeJson(); } catch( \IPS\Http\Request\Exception $e ) { die( "There was a problem fetching the request" ); } catch( \RuntimeException $e ) { die( "The response was not valid JSON" ); } var_dump( $response ); exit;

Большинство URL-адресов в Invision Community являются "дружественными", также известные как FURLs (ЧПУ – человекопонятные ссылки) - то есть, они на простом английском и легко читаются пользователями и поисковыми системами. FURL (ЧПУ) отображаются с помощью Invision Community в виде традиционных URL с параметрами, на основе преобразования, предоставляемого приложением. Например, FURL site.ru/messenger/compose может быть отображен как site.ru/index.php?app=core&module=messaging&controller=messenger&do=compose. Как загружаются контроллеры Контроллеры автоматически запускаются, когда совпадает URL. Параметры URL используются Invision Community, чтобы найти нужный контроллер: app=core Указывает, что контроллер находится в приложении “core” module=messaging Указывает, что контроллер находится в модуле обмена сообщениями “messaging”, в базовом приложении “core” controller=messenger Указывает, что мы загружаем контроллер “messenger”, в модуле обмена сообщениями “messaging”, в базовом приложении “core” do=сompose Параметр do не является обязательным, и позволяет вызывать конкретный метод в контроллере, чтобы обработать запрос. Если этот параметр опущен, то по умолчанию будет вызываться метод manage. Так, для URL site.ru/index.php?app=core&module=messaging&controller=messenger&do=compose, загружаемый контроллер будет находиться в /applications/core/modules/front/messaging/messenger.php, и будет вызываться метод compose внутри контроллера, чтобы обработать запрос. По этой структуре очень легко определить, какой именно способ, в каком контроллере обрабатывает запрос для любого заданного URL. Определение дружественных URL-адресов При разработке приложения, ваша FURL конфигурация создается в файле furl.json в каталоге /data вашего приложения. JSON структура определяет дружественный URL, реальный URL, который ему соответствует, и некоторые другие данные которые могут быть использованы. Простой пример FURL ... "messenger_compose": { "friendly": "messenger/compose", "real": "app=core&module=messaging&controller=messenger&do=compose" }, ... Ключ (в данном случае messenger_compose) это то, что идентифицирует этот FURL в IPS4. При создании ссылок в шаблонах или контроллерах, вы будете использовать этот ключ, чтобы указать, какой FURL будет использоваться для генерации и парсинга URL-адреса. Значение friendly это ЧПУ, который будут видеть пользователи. Значение real является фактическим URL, который будет использовать Invision Community, чтобы найти правильное app/module/controller для обработки запроса. FURLs с использованием параметров Хотя многие FURL статичные и простые, как в вышеуказанном примере, некоторые будут динамическими и будут включать в себя параметры, идентифицирующие конкретную запись, которая должна отображаться - например, просмотр темы на форуме. Для облегчения этой задачи, FURL определения поддерживают параметры. ... "profile": { "friendly": "profile/{#id}-{?}", "real": "app=core&module=members&controller=profile" }, ... Параметры, находящиеся внутри FURL заключены в фигурные скобки {}. Первый символ может быть либо #, чтобы соответствовать номеру, или @, чтобы соответствовать строкам. За этим следует имя параметра, и оно должно совпадать с именем параметра, который будет подставлен в реальном URL. Например, здесь мы используем {#id}, который совпадает с номером и приведет к &id=123 и передается в наш реальный URL. Тег {?} может быть использован для SEO заголовков; то есть дружественный текст, который идентифицирует отдельные записи, но который не является частью реального URL. Примером этого было бы название темы - оно включено в URL, чтобы помочь пользователям и поисковым системам, но только id темы используется для её поиска в реальном URL-адресе. Вы можете использовать несколько SEO заголовков в пределах URL, используя нулевой индексированный номер в теге, например {?0}, {?1} и {?2}. Вам не следует указывать FURL параметры, которые вы собираете в реальном URL; они автоматически добавляются к реальному URL-адресу диспетчером. В приведенном выше примере URL пользователь будет видеть что-то вроде site.ru/profile/123-имя-пользователя. Специфика FURL Порядок, в котором вы указываете ваши FURL значения имеет большое значение. Когда диспетчер пытается соотнести URL, он проходит последовательно через значения FURL, и останавливается на первом значении, которое подходит. Отсюда следует, что ваши более специфичные значения должны идти перед менее специфичными в furl.json. Например, предположим, у нас есть два значения, относящиеся к профилю пользователя. Одним из них является домашняя страница профиля, другой – страница редактирования профиля. Если мы указали значения таким образом: "profile": { "friendly": "profile/{#id}-{?}", "real": "app=core&module=members&controller=profile" }, "edit_profile": { "friendly": "profile/{#id}-{?}/edit", "real": "app=core&module=members&controller=profile&do=edit" }, …Тогда edit_profile не будет использоваться. profile/1-имя-пользователя URL будет найден первым и вызван диспетчером. Вместо этого следует сделать так, указав значения следующим образом: "edit_profile": { "friendly": "profile/{#id}-{?}/edit", "real": "app=core&module=members&controller=profile&do=edit" }, "profile": { "friendly": "profile/{#id}-{?}", "real": "app=core&module=members&controller=profile" }, ... это означает что edit_profile будет пропущен, пока не будет определено более частное значение, что позволяет более точно определить все запросы для обработки.

Одна из первых возможностей, которую необходимо сделать при настройке поисковой оптимизации на вашем сайте, должна быть дружественный URL адреса, они же ЧПУ (человекопонятные URL). Пример ЧПУ Например такой URL адрес: http://site.ru/?app=forums&module=forums&controller=topic&id=1 Можно сделать удобочитаемым: http://site.ru/topic/1-my-latest-hobbies/ Это важно, поскольку поисковые системы будут индексировать ваше сообщество, основываясь на URL адресах. Поэтому в примере выше будет больше шансов быть ранжированным в соответствии со словами "хобби" или "последние хобби". В админцентре откройте страницу Система > Продвижение > Поисковая оптимизация, где вы увидите следующую картину: SEO настройки в Invision Community Настройки Включить ЧПУ? Активация этой настройки даст вам более удобочитаемую структуру URL адресов, вместо набора различных параметров. Такие URL адреса более понятны для пользователей, и, что немаловажно, помогают поисковым система понять, что содержится на странице, расположенной по этому адресу. Перенаправлять URL-адреса? Эта настройка удалит index.php из ваших ЧПУ. Вам нужно будет скачать указанный в настройке файл и загрузить его в корневую директорию вашего сообщества. Например, выделенный текст будет удалён: http://site.ru/index?/topic/1-my-latest-hobbies/ Чтобы воспользоваться настройкой "Перенаправлять URL-адреса?", на вашем сервере должно быть установлено и включено расширение mod_rewrite. Если вы не уверены в этом, свяжитесь с вашим хостинг-провайдером. Перенаправлять на ЧПУ? Настройка даст возможность перенаправлять ваших пользователей на новые ЧПУ, если они перешли по недружественному URL адресу. Если у вас есть аккаунт в Google Analytics, на этой странице есть кнопка, с помощью которой вы можете разместить код на страницах вашего сайта.

URL адрес вашего сайта и детали, которые Invision Community использует для подключения к вашей MySQL базе данных, которые вы указывали при первой установке программного обеспечения, находятся в файле con_global.php в корневой директории вашего сайта, там же расположены файлы index.php и init.php. Тем не менее, сайт использует эти значения для создания некоторых уникальных ключей, предназначенных для определённых функций. Если вы изменили адрес вашего сайта или данные для подключения к базе данных, вам также необходимо создать и заменить ранее используемые ключи: Затрагивают изменения URL адреса или SQL данных: Настройка "Отдавать изображения с локального сервера?" в админцентре Система > Настройки > Постинг. Запросы поддержки в приложении Магазин. Затрагивают только изменение SQL данных, но не URL адреса: Хранение "Имя пользователя"/"Пароль" или "FTP данные" дополнительных полей в приложении Магазин. Учетные записи хостинга в приложении Магазин. IPS Connect. Если вы пользуетесь какими-либо из перечисленных выше возможностей, то, перед обновлением значений в файле conf_global.php, скачайте этот скрипт hashgenerator.php и загрузите его в корневую директорию вашего сайта. Далее откройте его в вашем браузере по ссылке, например site.ru/hashgenerator.php (где site.ru - адрес вашего сайта) и следуйте указанным инструкциям. Обновление хешей в Invision Community 4

Для смены URL адреса вашего сайт будет недостаточно редактирования конфигурационного файла в корне сайта. Для этих целей разработчиками был написан специальный скрипт, позволяющий изменить метод хранения данных сайта. Для смены URL адреса в Invision Community 4 следуйте следующим шагам: Загрузите файл changeUrl.php в корневую директорию вашего сайта.Измените адрес сайта в конфигурационном файле conf_global.php, расположенном в корне сайта.Обратитесь к файлу changeUrl.php в строке вашего браузера, например: http://site.ru/changeUrl.phpИзмените URL адрес и путь, если необходимо.Удалите файл changeUrl.php