URL Helper CodeIgniter User Guide

Файл помічника URL містить функції, які допоможуть працювати з URL.

Завантаження цього помічника

Цей помічник завантажується під час використання наступного коду:

Доступні такі функції:

Повертає URL-адресу сайту, як зазначено у вашому конфігураційному файлі. Файл index.php (або те, що ви вказали в параметрі index_page ), буде додано до URL, а також будь-які сегменти URL, передані функції, та url_suffix, вказаний у вашому конфігураційному файлі.

Вам рекомендується використовувати цю функцію щоразу, коли потрібно згенерувати локальну URL, що зробить ваш сайт більш портативним (незалежним від домену).

Опціонально функції можна передати сегменти, рядком чи масивом. Ось приклад використання рядка:

Приклад вище поверне щось на зразок: http://example.com/index.php/news/local/123

Ось приклад передачі сегментів у масиві:

$segments = array('news', 'local', '123');

Повертає основну URL-адресу сайту, як зазначено в конфігураційному файлі. Приклад:

Ця функція повертає лише site_url, без index_page або url_suffix.

Так само, як і site_url, ви можете просто передати сегменти масивом або рядком. Ось приклад використання рядка:

Приклад вище поверне щось на зразок: http://example.com/blog/post/123

Це корисно, тому що, на відміну від site_url(), ви можете передати шлях до файлу, наприклад, до зображення або до таблиці стилів. Наприклад:

Поверне щось на кшталт цього: http://example.com/images/icons/edit.png

current_url()

Повертає повну URL-адресу поточної сторінки, включаючи сегменти URI.

uri_string()

Повертає сегменти URI будь-якої сторінки, яка містить цю функцію. Наприклад, якщо ваш URL виглядає так:

Функція поверне таке:

index_page()

Повертає «індексну» сторінку вашого сайту, як це визначено в конфігураційному файлі. Приклад:

Створює стандартне HTML-посилання, ґрунтуючись на локальному URL сайту:

Приймає три опціональні параметри:

anchor( uri segments , text , attributes )

Перший параметр може містити будь-які сегменти, які потрібно додати до URL. Як і з функцією site_url(), сегменти можуть бути передані рядком чи масивом.

Примітка: Якщо ви будуєте внутрішні посилання за вашою програмою, не включайте основну URL-адресу (http://. ). Він буде автоматично доданий на основі інформації в конфігураційному файлі. Включайте тільки сегменти URI, які потрібно додати до URL.

Другий сегмент - це текст або інший вміст, який має бути в посиланні. Якщо ви залишите його порожнім, буде використано URL-адресу.

Третій параметр може містити список атрибутів, які потрібно додати до посилання. Атрибути можуть бути простим рядком або асоціативним масивом.

Ось кілька прикладів:

echo anchor('news/local/123', 'My News', 'title="News title"');

echo anchor('news/local/123', 'My News', array('title' => 'The best news!'));

anchor_popup()

$atts = array( 'width' => '800', 'height' => '600', 'scrollbars' => 'yes', 'status' => 'yes', 'resizable' => 'yes', 'screenx' => '0', 'screeny' => '0' );

echo anchor_popup('news/local/123', 'Click Me!', $atts);

Примітка: атрибути, вказані вище, використовуються за замовчуванням, тому ви можете вказувати лише ті, що відрізняються. Якщо ви хочете, щоб функція використовувала всі стандартні атрибути, просто передайте порожній масив у третьому параметрі:

echo anchor_popup('news/local/123', 'Click Me!', array());

Створює стандартне HTML-посилання на електронну пошту. Приклад використання:

echo mailto('[email protected]', 'Click Here to Contact Me');

Також, як і з функцією anchor(), можна передавати атрибути в третьому параметрі.

safe_mailto()

Конвертує лише URL:

$string = auto_link($string, 'url');

$string = auto_link($string, 'email');

Третій параметр визначає, чи мають посилання відкриватися у новому вікні. Значенням може бути TRUE або FALSE:

$string = auto_link($string, 'both', TRUE);

Приймає рядок на вхід і створює людину-дружній рядок URL. Це корисно, якщо ви, наприклад, використовуєте блог, який має заголовки в URL. Приклад:

$title = "What's wrong with CSS?";

Другий параметр визначає роздільник слів. За замовчуванням використовуються дефіси. Доступні опції: dash і underscore:

$title = "What's wrong with CSS?";

$url_title = url_title($title, 'underscore');

Третій параметр визначає, чи слід примусово наводити символи до нижнього регістру. За промовчанням немає. Вказується TRUE або FALSE:

$title = "What's wrong with CSS?";

$url_title = url_title($title, 'underscore', TRUE);

Ця функція додасть http://, якщо вона відсутня в URL. Надайте URL-адресу:

Другий опціональний параметр дозволяє вибирати між методами «location» і «refresh». Метод "location" швидше, але на серверах Windows може створювати деякі проблеми. Третій опціональний параметр дозволяє вам надіслати код відповіді HTTP. Наприклад, 301 для пошукових двигунів. За замовчуванням код 302. Третій параметр доступний лише методу «location». Приклади:

if($logged_in == FALSE) redirect('/login/form/', 'refresh'); >

// з редиректом 301 redirect('/article/13', 'location', 301);

Примітка: У випадку, якщо використовується ця функція, вона повинна бути викликана перед будь-яким надсиланням даних до браузера, оскільки використовує серверні заголовки.Примітка: Для дуже тонкого контролю за заголовками, використовуйте функцію set_header() бібліотеки Output.

---