Справочник по PHP
Вниманию читателей предлагается справочник по PHP.
Справочник предназначается для людей, уже освоивших азы программирования на языке PHP.
Справочник создан на основе информации, предоставленной на сайте «Справочник Web-языков» www.spravkaweb.ru.
Справочник по PHP
О этом справочнике
Справочник предназначается для людей, уже освоивших азы программирования на языке PHP.
Справочник создан на основе информации, предоставленной на сайте «Справочник Web-языков» www.spravkaweb.ru.
В связи с тем, что данный ресурс постоянно пополняется новой информацией, скачать обновленную версию справочника можно из раздела Download
http://www.spravkaweb.ru/download.php?user=help_php
Дата выхода данной версии справочника: 06:40, 25 марта 2007.
Также на сайте доступны для скачивания справочники по CSS, Perl, MySQL.
Синтаксис языка и операторы
Выражения
if
Позволяет организовывать выполнение фрагментов кода по условию.
Синтаксис :
if (выражение) statement
Может иметь неограниченную степень вложенности в другие IF.
if($a > $b) print "$a больше $b";
<?php
if($a > $b) {
echo "$a больше $b;
$b=$a;
}
?>
else
Расширяет возможности IF по части обработки вариантов выражения, когда оно равно FALSE.
Выражение ELSE выполняется только если IF равно FALSE.
if($a>$b) {
echo "a больше b";
} else {
echo "a меньше b";
}
elseif
Является комбинацией IF и ELSE. Позволяет выполнить выражение, если значение IF равно FALSE, но в отличии от ELSE оно выполниться, если выражение ELSEIF равно TRUE.
if ($a > $b) {
echo "a больше b";
} elseif ($a == $b) {
echo "a равно b";
} else {
echo "a меньше b";
}
if ... endif
Один из возможных вариантов группирования операторов с оператором IF.
Удобно при внедрении больших блоков HTML-кода внутрь оператора IF.
if ($a == 1):
echo "a равно 1";
elseif ($a == 2):
echo "a равно 2";
else:
echo "а не равно 1 и 2";
endif;
<?php if ($a==5):?>A=5<?php endif;?>
Блок HTML-кода A=5 будет виден, если выполнется условие $a==5
while
Простейший тип цикла в PHP. Заставляет PHP выполнять вложенные операторы до тех пор, пока условие равно TRUE. Если условие равно FALSE с самого начала, то цикл не выполнится не разу.
Синтаксис:
WHILE(условие)выражения
Можно сгруппировать несколько операторов внутри фигурных скобок или использовать альтернативный синтаксис :WHILE(условие)выражения... ENDWHILE;
<?php
$a=1;
while ($a <= 5) {
echo $a++;
}
?>
<?php
$a = 1;
while($a <= 5):
echo $a;
$a++;
endwhile;
?>
- Эти два примера выводят номера с 1 до 5.
do_while
Цикл, аналогичный WHILE, но значение логического выражения проверяется не до, а после окончания итерации. Основное отличие - то что цикл хоть один раз но выполнится.
<?php
$a = 1;
do {
echo $a;
} while ($a > 1);
?>
Можно прекратить использовать блок операторов в середине путем внедрения оператора BREAK в цикл DO..WHILE(0) :
<?php
do {
if ($a == 5) {
echo "A равно 5"
break;
}
$a *= $b;
if ($a < $minimum) {
break;
}
echo "A равен $a";
} while(0);
?>
for
Наиболее мощный цикл в PHP.
Синтаксис:
FOR (условие1; условие2; условие3)выражения
(условие2 - Проверяется в начале каждой итерации. Если оно равно TRUE, то цикл продолжается и выполняются вложенные операторы. Если оно равно FALSE, то цикл заканчивается.(условие3 - Выполняется (вычисляется) в конце каждой итерации.
Каждое из этих условий может быть пустым.
Пример1:
for ($a = 1; $a <= 5; $a++) {
echo $a;
}
Пример 2:
for ($a = 1;;$a++) {
if ($a > 5) {
break;
}
echo $a;
}
Пример 3:
$a = 1;
for (;;) {
if ($a > 5) {
break;
}
print $a;
$a++;
}
Пример 4:
for ($a = 1; $a <= 5; print $a, $a++);
PHP поддерживает альтернативный синтаксис FOR:
FOR(усл1; уcл2; усл3;):операторы;...;ENDFOR;
break
Прерывает выполнение текущего цикла.
Пример:
$a = 0;
while ($a < 5) {
if ($arr[$a] == "stop") {
break;
}
$a++;
}
continue
Переходит на начало ближайшего цикла.
<?php
while (list($key,$value) = each($arr)) {
if ($key % 2) {
continue;
}
do_something_odd ($value);
}
?>
switch
Сравнивает переменную или выражение с различными значениями и выполняет различные фрагменты кода в зависимости от того, чему будет равно значение выражения.
<?php
switch ($a) {
case 0:
echo "A равно 0";
break;
case 1:
echo "A равно 1";
break;
case 2:
echo "A равно 2";
break;
default:
echo "A не равно 0, 1, 2";
}
?>
require
Заменяет себя содержимым указанного файла.
Пример:
require("include.inc");
Но его нельзя поместить внутрь цикла и ожидать, что он включит содержимое другого файла несколько раз в процессе каждой итерации. Для этого есть INCLUDE.
include
Вставляет и выполняет содержимое указанного файла.
<?php
$files = array ("first.inc", "second.inc", "third.inc");
for ($a = 0; $a < count($files); $a++) {
include($files[$a]);
}
?>
Так как INCLUDE() это специальный оператор, требуется заключать его в фигурные скобки при использовании внутри условного оператора.
<?php
if ($a < 5) {
include("file_1.inc");
} else {
include("file_2.inc");
}
?>
function
Объявление функции.
Внутри функции может быть любой верный код PHP, даже объявление другой функции или класса. Функции должны быть объявлены перед тем, как на них ссылаться.
<?php
function foo ($arg_1, $arg_2, ..., $arg_n) {
echo "Пример функции.";
return $retvalue;
}
?>
Возвращение результатов:
<?php
function my_sqrt ($num) {
return $num * $num;
}
echo my_sqrt(4); //выведет 16
?>
Множественные результаты не могут быть возвращены в качестве результата, но вы можете реализовать это путем возврата списка:
function foo() {
return array (0, 1, 2);
}
list ($zero, $one, $two) = foo();
Аргументы:
Информация может быть передана функции через список аргументов, которые являются разделенным запятыми списком переменных и/или констант.
Списки аргументов переменной длины не поддерживаются, но того же можно достичь, передавая массивы.
function takes_array($input) {
echo "$input[0] + $input[1] = ", $input[0]+$input[1];
}
Передача по ссылке:
По умолчанию, аргументы функции передаются по значению. Для изменения аргументов в функции их надо передавать по ссылке.Для этого надо поставить амперсанд (&) перед именем аргумента в объявлении функции:
function foo( &$bar) {
$bar .= "и добавочная строка.";
}
$str = "Это строка, ";
foo($str);
echo $str; // выведет : "Это строка, и добавочная строка."
function foo($bar) {
$bar .= "и добавочная строка.";
}
$str = "Это строка, ";
foo($str);
echo $str; //выведет : "Это строка, "
foo(&$str);
echo $str; //выведет : "Это строка, и добавочная строка."
Значения по умолчанию:
Значение по умолчанию должно быть константой, а не переменной или членом класса.
function day ($type = "понедельник") {
echo "Сегодня $type.";
}
echo day(); //выведет : Сегодня понедельник.
echo day("вторник"); //выведет : Сегодня вторник.
Аргументы по умолчанию при описании должны находиться справо от остальных аргументов.
function day($day_num, $type = "понедельник") {
return "Сегодня $day_num - $type.";
}
old_function
Оператор OLD_FUNCTION позволяет вам определяить функцию используя синтаксис PHP/FI2 (за исключением того, что вы должны заменить "function" на "old_function").
Это свойство только для совместимости и должно использоваться лишь конверторами PHP/FI2 - PHP3. Описанные таким образом функции не могут быть вызваны из служебного кода PHP. Вы можете обойти это путем введения специальной функции в терминах PHP3, которая будет вызывать OLD_FUNCTION.
class
Набор переменных и функций, работающих с этими переменными.
<?php
class Cart {
var $items; // Количество вещей в корзине покупателя
// Добавить $num наименований типа $artnr в корзину
function add_item ($artnr, $num) {
$this->items[$artnr] += $num;
}
// Убрать $num наименований $artnr из корзины
function remove_item ($artnr, $num) {
if ($this->items[$artnr] > $num) {
$this->items[$artnr] -= $num;
return true;
} else {
return false;
}
}
}
?>
Классы это типы, то есть, заготовки для реальных переменных. Вы должны создавать переменные желаемого типа, используя оператор new:
$cart = new Cart;
$cart->add_item("10", 1);
Классы могут быть расширениями других классов. Расширенный класс обладает всеми переменными и функциями базового класса и тем, что вы определите при расширении класса. Это делается используя ключевое слово extends :
class Named_Cart extends Cart {
var $owner;
function set_owner ($name) {
$this->owner = $name;
}
}
Это определяет класс Named_Cart, который имеет все переменные и функции класса Cart плюс дополнительную переменную
$ncart = new Named_Cart; //Создать корзину
$ncart->set_owner ("kris");//Указать владельцаprint
$ncart->owner; //Распечатать имя владельца корзины
$ncart->add_item ("10", 1);//унаследовано из обычной корзины
Функции работы с данными
Математические функции
Функции округления
abs
Возвращает модуль числа.
Синтаксис:
mixed abs(mixed $number)
Тип параметра
$x = abs(-4); // $x=4
$x = abs(-7.45); // $x=7.45
round
Округление дробного числа до целого.
Синтаксис:
double round(double $val)
Округляет
$foo = round(3.4); // $foo == 3.0
$foo = round(3.5); // $foo == 4.0
$foo = round(3.6); // $foo == 4.0
$x = round(5.3); // $x=5
$x = round(5.4); // $x=5
$x = round(5.45); // $x=5
$x = round(5.5); // $x=6
ceil
Дополнение дробного числа до следующего целого.
Синтаксис:
int ceil(float $number)
Возвращает наименьшее целое число, не меньше
$x = ceil(5.0); // $x=5
$x = ceil(5.1); // $x=6
$x = ceil(5.9); // $x=6
floor
Удаление дробной части числа.
Синтаксис:
int floor(float $number)
Возвращает максимальное целое число, не превосходящее
$x = floor(5.1); // $x=5
$x = floor(5.9); // $x=5
Случайные числа
srand
Производит инициализацию генератора случайных чисел.
Синтаксис:
void srand(int seed)
Инициализирует генератор случайных чисел занчением
srand((double) microtime()*1000000);
$random = rand();
echo $random;
getrandmax
Возвращает максимально возможное случайное число.
Синтаксис:
int getrandmax()
Эта функция возвращает максимальное значение, которое можно получить при помощи функции генерации случайных чисел rand().
Обычно это 32767
rand
Производит генерацию случайного числа.
Синтаксис:
int rand([int max [, int min]])
При вызове с необязательными параметрами
Если параметры
Для корректной работы данной функции перед ее использованием нужно проинициализировать генератор случайных чисел функцией srand().
mt_rand
Функция возвращает MT-случайное число, достаточно равномерно даже для того, чтобы использовать его в криптографии.
Синтаксис:
int mt_rand(int $min=0, int $max=RAND_MAX)
Если вы хотите генерировать числа не от
mt_srand(time()+(double)microtime()*1000000);
$x = mt_rand(1,100); // $x - значение от 1 до 100
mt_srand
Настраивает MT-генератор случайных чисел на новую последовательность.
Синтаксис:
void mt_srand(int seed)
Дело в том, что хотя числа, генерируемые mt_rand(), достаточно равновероятны, но у них есть один нелостаток: последовательность сгенерированных чисел будет одинакова если сценарий вызывать несколько раз подряд. Функция mt_srand() как раз решает данную проблему: она выбирает новую последовательность на основе параметра
mt_srand(time()+(double)microtime()*1000000);
for($i=0;$i<=10;$i++) {
$x = mt_rand(1,10);
};
В этом случае последовательность устанавливается на основе времени запуска сценария (в секундах), поэтому она достаточно непредсказуема. Для еще более надежного результата рекомендуется приплюсовать сюда еще микросекунды (что и было сделано), а также идентификатор процесса, вызывавшего сценарий.
mt_getrandmax
Возвращает максимальное MT-случайное число.
Синтаксис:
int mt_getrandmax()
Возвращает максимальное число, которое может быть сгенерированно функцией mt_rand() - иными словами, константу
$max = mt_getrandmax();
// $max = 2147483647
lcg_value
функция генерирует случайное дробное число.
Синтаксис:
double lcg_value()
Эта функция возвращает псевдослучайное дробное число в диапазоне от
Перевод в различные системы счисления
base_convert
Конвертация числа из одной системы счисления в другую.
Синтаксис:
string base_convert(string $number, int $frombase, int $tobase)
Переводит число
$x = base_convert("FF",16,2); //$x = 11111111
$x = base_convert("11111111",2,16); //$x = FF
$x = base_convert("200",10,16); //$x = C8
bindec
Производит конвертацию двоичного числа в десятичное.
Синтаксис:
int bindec(string binary_string)
Преобразует двоичное число, заданное в строке
$x = bindec(11111111); // $x = 255
$x = bindec(10101010); // $x = 170
$x = bindec(2147483647); // $x = 1111111111111111111111111111111
decbin
Производит конвертацию десятичного числа в двоичное.
Синтаксис:
string decbin(int $number)
Возвращает строку, представляющую собой двоичное представление целого числа
Существует аналогичные функции для восьмеричной и шестнадцатиричной систем. Называются они так же, только вместо "bin" подставляются соответственно "oct" и "hex".
$x = decbin(255); // $x = 11111111
$x = decbin(2147483647); // $x = 1111111111111111111111111111111
dechex
Производит конвертацию десятичного числа в шестнадцатеричное.
Синтаксис:
string dechex(int number)
Возвращает строку, представляющую собой шестнадцатеричное представление целого числа
$x = dechex(2147483647); // $x = 7fffffff
decoct
Производит конвертацию десятичного числа в восьмеричное.
Синтаксис:
string decoct(int number)
Возвращает строку, представляющую собой восьмеричное представление целого числа
$x = dechex(2147483647); // $x = 17777777777
hexdec
Производит конвертацию шестнадцатеричного числа в десятичное.
Синтаксис:
int hexdec(string hex_string)
Преобразует шестнадцатеричное число, заданное в строке
$x = hexdec(7fffffff); // $x = 2147483647
octdec
Производит конвертацию восьмеричного числа в десятичное.
Синтаксис:
int octdec(string octal_string)
Преобразует восьмеричное число, заданное в строке
$x = octdec(17777777777); // $x = 2147483647
deg2rad
Производит конвертацию градусов в радианы.
Синтаксис:
double deg2rad(double number)
Преобразует градусы, заданные в параметре
rad2deg
Производит конвертацию радианов в градусы.
Синтаксис:
double rad2deg(double number)
Преобразует радианы, заданные в параметре
number_format
Форматирование числа.
Синтаксис:
number_format($number, $decimals, $dec_point=".", $thousands_sep=",");
Эта функция форматирует число с плавающей точкой с разделением его на триады с указанной точностью. Она может быть вызвана с двумя или четырьмя аргументами, но не с тремя! Параметр
Параметр
Минимум и максимум
min
Эта функция возвращает наименьшее из чисел, заданных в ее аргументах.
Синтаксис:
mixed min(mixed $arg1 [int $arg2, ..., int $argn])
Различают два способа вызова этой функции: с одним параметром или с несколькими. Если указан лишь один параметр (первый), то он обязательно должен быть массивом и возвращается минимальный элемент этого массива. В противном случае первый (и остальные) аргументы трактуются как числа с плавающей точкой, они сравниваются, и возвращается наименьшее. Тип возвращаемого значения выбирается так: если хотябы одно из чисел, переданных на вход, задано в формате с плавающей точкой, то и результат будет с плавающей точкой, в противном случае результат будет целым числом. С помощью этой функции нельзя лексографически сравнивать строки - только числа.
$x = min(5,3,4,6,5,6,8,9);
// $x = 3
$x[0]=4;
$x[1]=1;
$x[2]=5;
$x[3]=2;
echo min($x); // выведет 1
max
Получение наибольшего аргумента.
Синтаксис:
mixed max(mixed $arg1 [int $arg2, ..., int $argn])
Функция работает аналогично min(), только ищет максимальное значение.
$x = max(5,3,4,6,5,6,8,9);
// $x = 9
$x[0]=4;
$x[1]=1;
$x[2]=5;
$x[3]=2;
echo max($x); // выведет 5
Степенные функции
sqrt
Возвращает квадратный корень из аргумента.
Синтаксис:
float sqrt(float $arg)
Если аргумент отрицателен, то генерируется предупреждение, но работа программы не прекращается!
$x = sqrt(9);
// $x = 3
echo sqrt(25); // выведет 5
echo sqrt(-25); // выведет -1.#IND
log
Возвращает натуральный логарифм аргумента.
Синтаксис:
float log(float $arg)
В случае недопустимого числа печатает предупреждение, но не завершает программу.
$x = log(exp(2)); // exp(2) - e в степени 2
// $x = 2
$x = log(M_E); // $x = 1
echo log(10); // выведет 2.302585092994
log10
Возвращает десятичный логарифм аргумента.
Синтаксис:
float log10(float $arg)
В случае недопустимого числа печатает предупреждение, но не завершает программу.
echo log10(100); // выведет 2
exp
Возвращает e (2,718281828) в степени
Синтаксис:
float exp(float $arg)
$x = exp(1);
// $x = 2.718281828459
pow
Возведение в степень.
Синтаксис:
float pow(float $base, float $exp)
Возвращает
$x = pow(3,2); // $x = 9
$x = pow("3",2); // $x = 9
Тригонометрия
sin
Возвращает синус аргумента.
Синтаксис:
float sin(float $arg)
Аргумент задается в радианах.
$x = sin(M_PI_2); // $x = 1
cos
Возвращает косинус аргумента.
Синтаксис:
float cos(float $arg)
$x = cos(0); // $x = 0
$x = cos(M_PI); // $x = -1
tan
Возвращает тангенс аргумента, заданного в радианах.
Синтаксис:
float tan(float $arg)
$x = tan(M_PI_4); // $x = 1
acos
Возвращает арккосинус аргумента.
Синтаксис:
float acos(float $arg)
$x = acos(0); // $x = pi/2
$x = acos(1); // $x = 0
asin
Возвращает арксинус.
Синтаксис:
float asin(float $arg)
$x = asin(0); // $x = 0
$x = asin(1); // $x = pi/2
atan
Возвращает арктангенс аргумента.
Синтаксис:
float atan(float $arg)
$x = atan(0); // $x = 0
$x = atan(1); // $x = pi/4
atan2
Получение арктангенса двух чисел.
Синтаксис:
float atan2(float $y, float $x)
Возвращает арктангенс величины
$x = atan2(1,1); // $x = pi/4
$x = atan2(-1,-1); // $x = -3*pi/4
pi
Возвращает число пи - 3,14.
Синтаксис:
double pi()
Эту функцию обязательно нужно вызывать с парой пустых скобок:
$x = pi()*2 // $x = 31.415926535898
Функции повышенной точности BCMath
bcadd
Сложение двух чисел произвольной точности.
Синтаксис:
string bcadd(string left_operand, string right_operand [, int scale]);
Эта функция возвращает строковое представление суммы двух параметров (
Точность (
bccomp
Сравнение двух чисел произвольной точности.
Синтаксис:
int bccomp(string left_operand, string right_operand, [int scale]);
Сравнивает числа (
bcdiv
Операция деления для двух чисел произвольной точности.
Синтаксис:
string bcdiv(string left_operand, string right_operand [, intscale]);
Делит
bcmod
Возвращает остаток целочисленного деления.
Синтаксис:
string bcmod(left_operand, string modulus);
Данная функция возвращает остаток от целочисленного деления
bcmul
Операция умножения для двух чисел произвольной точности.
Синтаксис:
string bcmul(string left_operand, string right_operand [, int scale]);
Производит умножение
bcpow
Возведение одного числа произвольной точности в степень другого.
Синтаксис:
string bcpow(string x, string y, [int scale]);
Возведение
bcscale
Устанавливает точность вычислений.
Синтаксис:
string bcscale(int scale);
Эта функция устанавливает заданную по умолчанию точность вычислений для всех математических функций
bcsqrt
Получение квадратного корня числа произвольной точности.
Синтаксис:
string bcsqrt(string operand [,int scale]);
Возвращает квадратный корень аргумента
bcsub
Вычитает одно число произвольной точности из другого.
Синтаксис:
string bcsub(string left_operand, right_operand [, int scale]);
Возвращает разность двух переменных, указанных в параметрах функции (
Функции GMP
Подразделы
Функции
Введение
Функции этого вида позволяют работать с целыми числами повышенной точности определенного формата используя библиотеку GNU MP.Эта библиотека не входит в стандартный пакет PHP. Загрузить коды библиотеки и документацию по ней можно на сайте http://www.swox.com/gmp/.
Функции, приведенные в этой библиотеке, могут также работать с обычными целочисленными аргументами. В этом случае они будут автоматически преобразовываться в формат GMP. Но для увеличения производительности рекомендуется все же использовать числа формата GMP.
Значения функции GMP
gmp_init
Создает число GMP.
Синтаксис:
resource gmp_init(mixed number)
Число GMP создается из целочисленного или строкового аргумента.
В строке может быть указано число десятеричного или шестнадцатеричного формата. Если это шестнадцатеричный формат, то перед числом должен стоять префикс
$x = gmp_init(45);
$y = gmp_init("46");
$z = gmp_init("0xfa4b");
Данная функция не обязательна (аргументы автоматически конвертируются в формат GMP), но желательна (при использовании функции gmp_init() повышается быстродействие).
gmp_intval
Преобразование GMP-числа в целое.
Синтаксис:
int gmp_intval(resource gmpnumber)
Эта функция конвертирует GMP-число в целое в том случае, если получаемое число не превышает своего максимально допустимого размера.
gmp_strval
Преобразование GMP-числа в строку.
Синтаксис:
string gmp_strval(resource gmpnumber [, int base])
Функция возвращает число
Параметр
$x = gmp_init("0xf1a5");
echo "В десятичной : ".gmp_strval($x);
echo "В base-36: ".gmp_strval($x,36);
gmp_abs
Вычисляет модуль GMP-числа.
Синтаксис:
resource gmp_abs(resourse x)
Возвращает абсолютное значение числа, заданного в параметре
gmp_sign
Возвращает знак числа.
Синтаксис:
int gmp_sign(resource x)
Функция gmp_sign() возвратит 1, если
gmp_neg
Возвращает отрицательное значение числа.
Синтаксис:
recource gmp_neg(resource x)
Возвратит
Арифметика
gmp_add
Сложение двух чисел.
Синтаксис:
recource gmp_add(resource x, recource y)
Функция возвратит GMP-число, равное сумме аргументов
gmp_sub
Вычитание двух чисел.
Синтаксис:
recource gmp_sub(resource x, recource y)
Функция возвратит GMP-число, равное разности аргументов
gmp_mul
Умножение двух чисел.
Синтаксис:
recource gmp_mul(resource x, recource y)
Функция возвратит GMP-число, равное произведению аргументов
gmp_div
Деление двух чисел.
Синтаксис:
recource gmp_div(resource x, recource y [, int round])
Функция возвратит GMP-число, равное делению аргументов
Эта функция - синоним gmp_div_q().
gmp_div_q
Деление двух чисел.
Синтаксис:
recource gmp_div_q(resource x, recource y [, int round])
Функция возвратит GMP-число, равное делению аргументов
У этой функции есть синоним - gmp_div().
gmp_div_r
Возвращает остаток от целочисленного деления.
Синтаксис:
recource gmp_div_r(resource x, recource y [, int round])
Функция возвращает остаток от деления
gmp_div_qr
Производит деление с остатком.
Синтаксис:
array gmp_div_qr(resource x, recource y [, int round])
Данная функция комбинирует в себе действие двух предыдущих функций gmp_div_q() и gmp_div_r(). Она возвращает массив, состоящий из двух элементов:
$x=gmp_init("0xf3c3b5");
$result=gmp_div_qr($x, "0xb1");
echo "Целое: ".gmp[strval($result[0]);
echo "Остаток: ".gmp[strval($result[1]);
gmp_mod
Возвращает модуль остатка деления.
Синтаксис:
resource gmp_mod(resource x, recource y)
Данная функция эквивалентна gmp_div_r(), за исключением того, что она возвращает абсолютное значение.
gmp_divexact
Производит безостаточное деление.
Синтаксис:
resource gmp_divexact(resource x, recource y)
Данная функция использует алгоритм "точного" деления. Результат будет достоверным, только если
gmp_cmp
Производит сравнение двух чисел.
Синтаксис:
int gmp_cmp(resource x, recource y)
Функция возвратит положительное значение, если
Математика
gmp_fact
Вычисляет факториал.
Синтаксис:
resource gmp_fact(resourse x)
Возвращает факториал числа, заданного в параметре
gmp_sqrt
Вычисляет квадратный корень.
Синтаксис:
resource gmp_sqrt(resourse x)
Возвращает квадратный корень числа, заданного в параметре
gmp_sqrtrm
Вычисляет квадратный корень с остатком.
Синтаксис:
array gmp_sqrtrm(resourse x)
Данная функция возвращает массив, в котором элемент с индексом [0] - это квадратный корень аргумента, элемент с индексом [1] - разность между аргументом и элементом [0] в квадрате.
gmp_perfect_square
Определяет, является ли число полным квадратом.
Синтаксис:
bool gmp_perfect_square(resourse x)
Функция gmp_perfect_square() возвратит
gmp_pow
Возведение в степень.
Синтаксис:
resource gmp_pow(resourse x, int y)
Эта функция возвращает результат, равный возведения аргумента
echo gmp_pow(2,3); // Выведет 8
echo gmp_pow(0,0); // Выведет 1
gmp_powm
gmp_prob_prime
Проверка "вероятно" простого числа.
Синтаксис:
int gmp_prob_prime(resourse x [, int reps])
Эта функция возвратит 0, в случае если x сложное число, т.е. имеющее более двух целых делителей. Возвратит 1, если
Аргумент
Эта функция использует алгоритм вероятностного теста Миллера-Рабина.
gmp_gcd
Находит наибольший общий делитель.
Синтаксис:
resource gmp_gcd(resourse x, resource y)
Всегда возвращает положительный результат.
gmp_gcdext
Нахождение наибольшего общего делителя со множителями.
Синтаксис:
array gmp_gcdext(resourse x, resource y)
Функция gmp_gcdext() возвращает массив со значениями g,s,t, такими, что x*s+y*t=g=НОД(x,y), гдн НОД - наибольший общий делитель.
gmp_invert
Производит инверсию по модулю.
Синтаксис:
resource gmp_invert(resourse x, resource y)
Функция возвращает дополнение
gmp_legendre
Возвращает число Легранжа.
Синтаксис:
int gmp_legendre(resourse x, resource p)
Функция возвращает число Легранжа.
gmp_jacobi
Возвращает число Якоби.
Синтаксис:
int gmp_jacobi(resourse x, resource p)
Функция возвращает число Якоби.
gmp_random
Производит генерацию случайного числа.
Синтаксис:
resource gmp_random(int limited)
gmp_popcount
Получение популяции.
Синтаксис:
int gmp_popcount(resource x)
Функция возвращает числитель популяции.
gmp_hamdist
Вычисление дистанции.
Синтаксис:
int gmp_hamdist(resource x, resource y)
Функция возвращает дистанцию между числами
Бинарные операции
gmp_and
Логическое И (AND).
Синтаксис:
resource gmp_and(resource x, resource y)
gmp_or
Логическое ИЛИ (OR).
Синтаксис:
resource gmp_or(resource x, resource y)
gmp_xor
Логическое исключающее-ИЛИ (XOR).
Синтаксис:
resource gmp_xor(resource x, resource y)
gmp_setbin
Установка бита.
Синтаксис:
resource gmp_setbin(resource &x, int index [, bool set_clear])
Устанавливает бит в позиции
gmp_clrbit
Производит сброс бита.
Синтаксис:
resource gmp_clrbit(resource &x, int index)
Устанавливает бит в позиции
gmp_scan0
Производит поиск бита 0.
Синтаксис:
int gmp_scan0(resource x, int start)
Функция gmp_scan0() ищет в числе
gmp_scan1
Производит поиск бита 1.
Синтаксис:
int gmp_scan1(resource x, int start)
Функция gmp_scan0() ищет в числе
Работа с массивами
Введение
Эти функции позволят вам различными способами оперировать с массивами. Массивы идеально подходят для хранения, изменения и работы с наборами переменных.
Поддерживаются одно- и многоразмерные массивы, как созданные пользователем, так и возвращенные в качестве результата какой-либо функцией. Существуют специальные функции для работы с базами данных, облегчающие работу с массивами данных, возвращаемых в результате выполнения запросов; также существуют функции, возвращающие массивы в качестве результата.
Требования
Эти функции всегда доступны.
Установка
Для использования этих функций не требуется проведение установки, поскольку они являются частью ядра PHP.
Настройка во время выполнения
Данное расширение не определяет никакие директивы конфигурации в
Типы ресурсов
Данное расширение не определяет никакие типы ресурсов.
Предопределенные константы
Перечисленные ниже константы всегда доступны как часть ядра PHP.
Флаги типа сортировки:
Введение
Введение
Эти функции позволят вам различными способами оперировать с массивами. Массивы идеально подходят для хранения, изменения и работы с наборами переменных.
Поддерживаются одно- и многоразмерные массивы, как созданные пользователем, так и возвращенные в качестве результата какой-либо функцией. Существуют специальные функции для работы с базами данных, облегчающие работу с массивами данных, возвращаемых в результате выполнения запросов; также существуют функции, возвращающие массивы в качестве результата.
Требования
Эти функции всегда доступны.
Установка
Для использования этих функций не требуется проведение установки, поскольку они являются частью ядра PHP.
Настройка во время выполнения
Данное расширение не определяет никакие директивы конфигурации в
Типы ресурсов
Данное расширение не определяет никакие типы ресурсов.
Предопределенные константы
Перечисленные ниже константы всегда доступны как часть ядра PHP.
Флаги типа сортировки:
Создание массива
array
Создание и инициализация массива.
Синтаксис:
array array([mixed ...])
Функция возвращает созданный массив. Индексы и значения в массиве разделяются оператором
Индекс может быть как числовым, так и строковым. В ассоциированных массивах индекс всегда ведет себя как строковой. В случае, если индекс не указан, будет подставляться автоинкремент (на 1 больше), начиная с 0. Если при создании массива были указаны два элемента с одинаковыми индексами, то последний элемент заменяет первый.
Пример использования функции array():
<?php
$arr=array( // Далее мы создадим двумерный массив
"fruit" => array("a"=>"orange", "b"=>"banan", "c"=>"apple"),
// эта запись эквивалентна записи: $arr["fruit"]["a"]="orange"; и т.д.
"number" => array(1,2,3,4,5,6),
// эта запись эквивалентна записи: $arr["number"][]=1; и т.д.
"hotel" => array("first", 5=>"second", "third")
);
?>
$arr=array(1, 1, 1, 1, 2=>5, 19, 3=>20);
print_r($arr);
// Далее распечатка этого массива
Array
(
[0] => 1
[1] => 1
[2] => 5
[3] => 20
[4] => 19
)
$arr=array(1 => "Январь", "Февраль", "Март");
print_r($arr);
// распечатка
Array
(
[1] => Январь
[2] => Февраль
[3] => Март
)
Функция поддерживается PHP 3, PHP 4, PHP 5
range
Создает массив и заполняет его значениями.
Синтаксис:
array range(int low, int high[, int step])
Функция range() возвращает массив с значениями от
Дополнительный параметр
Если третий параметр указан, то числа будут вводиться от
Пример использования функции range():
<?php
// array(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12)
foreach (range(0, 12) as $number) {
echo $number;
}
// The step parameter was introduced in 5.0.0
// array(0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100)
foreach (range(0, 100, 10) as $number) {
echo $number;
}
// Use of character sequences introduced in 4.1.0
// array("a", "b", "c", "d", "e", "f", "g", "h", "i");
foreach (range("a", "i") as $letter) {
echo $letter;
}
// array("c", "b", "a");
foreach (range("c", "a") as $letter) {
echo $letter;
}
?>
Функция поддерживается PHP 3 = 3.0.8, PHP 4, PHP 5
Сортировка массивов
array_reverse
Расстановка элементов массива в обратном порядке.
Синтаксис:
array array_reverse(array arr [, bool preserve_keys])
Функция array_reverse() возвращает массив, элементы которого следуют в обратном порядке относительно массива, переданного в параметре. При этом связи между ключами и значениями не теряются, если дополнительный параметр
Пример использования функции array_reverse():
<?php
$input = array("php", 4.0, array("green", "red"));
$result = array_reverse($input);
$result_keyed = array_reverse($input, true);
?>
Этот пример сделает оба массива
Array( [0] => Array ( [0] => green [1] => red ) [1] => 4 [2] => php)Array( [2] => Array ( [0] => green [1] => red ) [1] => 4 [0] => php)
Примечание: Второй параметр
Функция поддерживается PHP 4, PHP 5
shuffle
Перемешивание элементов массива.
Синтаксис:
void shuffle(array arr)
Функция shuffle() "перемешивает" список, переданный ей первым параметром
Пример использования функции shuffle():
<?php
$numbers = range(1, 20);
srand((float)microtime() * 1000000);
shuffle($numbers);
while (list(, $number) = each($numbers)) {
echo "$number ";
}
?>
Замечание: Начиная с PHP 4.2.0, больше нет необходимости инициализировать генератор случайных чисел функциями srand() или mt_srand(), поскольку теперь это происходит автоматически.
Функция поддерживается PHP 3 = 3.0.8, PHP 4, PHP 5
sort
Сортировка массива по возрастанию.
Синтаксис:
bool sort(array arr [, int sort_flags])
Функция sort() предназначена для сортировки массивов в порядке возрастания.
Замечание: Эта функция изменяет ключи у отсортированных значений. Т.е. любой ассоциативный массив воспринимается этой функцией как список. После упорядочивания последовательность ключей превращается в 0,1,2,..., а значения нужным образом перераспределяются. Как видим, связи между параметрами ключ=значение не сохраняются, более того - ключи просто пропадают, поэтому сортировать что-либо, отличное от списка, вряд ли целесообразно.
Пример использования функции sort():
<?php
$fruits = array("lemon", "orange", "banana", "apple");
sort($fruits);
reset($fruits);
while (list($key, $val) = each($fruits)) {
echo "fruits[" . $key . "] = " . $val . "n";
}
?>
Этот пример выведет:
fruits[0] = applefruits[1] = bananafruits[2] = lemonfruits[3] = orange
Аргумент sort_flags задает следующие флаги сортировки:
Функция поддерживается PHP 3, PHP 4, PHP 5
rsort
Сортировка массива по убыванию.
Синтаксис:
bool rsort ( array array [, int sort_flags])
Функция rsort() сортирует массив
Функция возвращает
Пример использования функции rsort():
<?php
$fruits = array("lemon", "orange", "banana", "apple");
rsort($fruits);
reset($fruits);
while (list($key, $val) = each($fruits)) {
echo "$key = $valn";
}
?>
Этот пример выведет:
0 = orange1 = lemon2 = banana3 = apple
Аргумент
Функция поддерживается PHP 3, PHP 4, PHP 5
asort
Сортировка ассоциативного массива по возрастанию.
Синтаксис:
bool asort(array arr [, int sort_flags])
Функция asort() сортирует массив, указанный в ее параметре, так, чтобы его значения шли в алфавитном (если это строки) или возрастающем (для чисел) порядке. При этом сохраняются связи между ключами и соответствующими им значениями, т.е. некоторые пары ключ=значение просто "всплывают" наверх, а некоторые - наоборот, "опускаются".
Функция возвращает
Пример использования функции asort():
<?php
$fruits = array("d" => "lemon", "a" => "orange", "b" => "banana", "c" => "apple");
asort($fruits);
reset($fruits);
while (list($key, $val) = each($fruits)) {
echo "$key = $valn";
}
?>
Пример выведет следующее:
c = appleb = bananad = lemona = orange
Массив
Метод сортировки может быть изменен при помощи необязательного параметра
Этот параметр может указать, как сравнивать значения (как строки или как числа). Он может принимать следующие предопределенные значения:
Этот параметр был введен в PHP начиная с 4 версии.
Функция поддерживается PHP 3, PHP 4, PHP 5
arsort
Сортировка ассоциативного массива по убыванию.
Синтаксис:
bool arsort(array arr [, int sort_flags])
Функция arsort() сортирует массив
Эта функция используется главным образом там, где существенен порядок элемента в массиве.
Функция возвращает
Пример использования функции arsort():
$arr=array("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple");
arsort($arr);
reset($arr);
while(list ($key, $val) = each ($arr)) {
echo "$key = $val<BR>l";
}
Пример выведет:
a = oranged = lemonb = bananac = apple
Массив
Метод сортировки может быть изменен при помощи необязательного параметра
Этот параметр может указать, как сравнивать значения (как строки или как числа). Он может принимать следующие предопределенные значения:
Этот параметр был введен в PHP начиная с 4 версии.
Функция поддерживается PHP 3, PHP 4, PHP 5
ksort
Сортировка массива по возрастанию ключей.
Синтаксис:
bool ksort(array arr [, int sort_flags])
Функция ksort() сортирует массив в порядке возрастания ключей с сохранением взаимосвязей ключей и значений. Эта функция особенно полезна при сортировке ассоциативных массивов.
Функция возвратит
Пример использования функции ksort():
<?php
$fruits = array("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple");
ksort($fruits);
reset($fruits);
while (list($key, $val) = each($fruits)) {
echo "$key = $valn";
}
?>
Данный пример выведет:
a = orangeb = bananac = appled = lemon
Аргумент
Функция поддерживается PHP 3, PHP 4, PHP 5
krsort
Сортировка массива по убыванию индексов.
Синтаксис:
bool krsort(array arr [, int sort_flags])
Функция krsort() сортирует ключи в массиве arr в обратном порядке. При этом связка ключей и значений сохраняется. Эта функци полезна при сортировке ассоциативных массивов.
Функция возвращает
Пример использования функции krsort():
<?php
$fruits = array("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple");
krsort($fruits);
reset($fruits);
while (list($key, $val) = each($fruits)) {
echo "$key = $valn";
}
?>
Данный пример выведет:
d = lemonc = appleb = bananaa = orange
Аргумент
Функция поддерживается PHP 3 = 3.0.13, PHP 4, PHP 5
natsort
Выполняет "естественную" сортировку массива.
Синтаксис:
void natsort(array arr)
Функция natsort() сортирует массив
Пример использования функции natsort():
<?php
$array1 = $array2 = array("img12.png", "img10.png", "img2.png", "img1.png");
sort($array1);
echo "Стандартная сортировкаn";
print_r($array1);
natsort($array2);
echo "nЕстественная сортировкаn";
print_r($array2);
?>
Этот пример выведет следующее:
Стандартная сортировкаArray( [0] => img1.png [1] => img10.png [2] => img12.png [3] => img2.png)Естественная сортировкаArray( [3] => img1.png [2] => img2.png [1] => img10.png [0] => img12.png)
Функция поддерживается PHP 4, PHP 5
natcasesort
Выполняет естественную сортировку массива без учета регистра символов.
Синтаксис:
void natcasesort(array arr)
Функция natcasesort() сортирует массив arr в естественном для человека порядке с сохранением индексных ассициаций.
Эта функция схожа с natsort(), только не учитывает регистр символов.
Пример использования функции natcasesort():
<?php
$array1 = $array2 = array("IMG0.png", "img12.png", "img10.png",
"img2.png", "img1.png", "IMG3.png");
sort($array1);
echo "Стандартная сортировкаn";
print_r($array1);
natcasesort($array2);
echo "nЕстественная сортировка (без учета регистра)n";
print_r($array2);
?>
Приведенный пример выведет следующее:
Стандартная сортировкаArray( [0] => IMG0.png [1] => IMG3.png [2] => img1.png [3] => img10.png [4] => img12.png [5] => img2.png)Естественная сортировка (без учета регистра)Array( [0] => IMG0.png [4] => img1.png [3] => img2.png [5] => IMG3.png [2] => img10.png [1] => img12.png)
Функция поддерживается PHP 4, PHP 5
uasort
Пользовательская сортировка ассоциативного массива с сохранением индексных ассоциаций.
Синтаксис:
bool uasort(array arr, function cmp_function)
Функция uasort() сортирует массив arr с сохранением индексных ассоциаций, используя для сравнения индексов элементов пользовательскую функцию, указанную аргументом
Эта функция используется главным образом когда соответствие индексов и значений массива существенно.
Функция uasort() возвращает
Замечание: Смотрите функции usort() и uksort() для написания пользовательской функции.
Функция поддерживается PHP 3 =3.0.4, PHP 4, PHP 5
uksort
Пользовательская сортировка массива по ключам.
Синтаксис:
bool uksort(array arr, function cmp_function)
Функция uksort() сортирует массив arr по индексам с сохранением индексных ассоциаций, используя для сравнения индексов элементов пользовательскую функцию, указанную в аргументе
Функция uksort() возвращает
Довольно часто нам приходится сортировать что-то по более сложному критерию, чем просто по алфавиту. Например, пусть в
1 пример использования функции uksort():
// Эта функция должна сравнивать значения $f1 и $f2 и возвращать:
// -1, если $f1<$f2,
// 0, если $f1==$f2
// 1, если $f1>$f2
// Под < и > понимаем следование этих имен в выводимом списке
function FCmp($f1,$f2)
{ // Каталог всегда предшествует файлу
if(is_dir($f1) && !is_dir($f2)) return -1;
// Файл всегда идет после каталога
if(!is_dir($f1) && is_dir($f2)) return 1;
// Иначе сравниваем лексиграфически
if($f1<$f2) return -1; elseif($f1>$f2) return 1; else return 0;
}
// Пусть $Files содержит массив с ключами - именами файлов
// в текущем каталоге. Отсортируем его.
uksort($Files,"FCmp"); //передаем функцию сортировки "по ссылке"
2 пример использования функции uksort():
<?php
function cmp($a, $b)
{
if ($a == $b) {
return 0;
}
return ($a > $b) ? -1 : 1;
}
$a = array(4 => "four", 3 => "three", 20 => "twenty", 10 => "ten");
uksort($a, "cmp");
while (list($key, $value) = each($a)) {
echo "$key: $valuen";
}
?>
Этот пример выведет:
20: twenty10: ten4: four3: three
Функция поддерживается PHP 3 =3.0.4, PHP 4, PHP 5
usort
Пользоваетльская сортировка значений массива.
Синтаксис:
bool usort(array arr, callback cmp_function)
Функция usort() сортирует массив
Эта функция как бы является "гибридом" функций uasort() и sort(). От sort() она отличается тем, что критерий сравнения обеспечивается пользовательской функцией. А от uasort() - тем, что она не сохраняет связей между ключами и значениями, а потому пригодна разве что для сортировки списков.
Пример использования функции usort():
<?php
function cmp($a, $b)
{
if ($a == $b) {
return 0;
}
return ($a < $b) ? -1 : 1;
}
$a = array(3, 2, 5, 6, 1);
usort($a, "cmp");
while (list($key, $value) = each($a)) {
echo "$key: $valuen";
}
?>
Пример одномерного массива:
function cmp($a, $b) {
if($a==$b) return 0;
return ($a > $b) ? -1 : 1;
}
$a=array (3,2,5,6,1);
usort($a, "cmp");
while(list($key,$val)=each($a)) {
echo "$key: $valn";
}
При выполнении будет напечатано:
0: 61: 52: 33: 24: 1
Пример многомерного массива:
function cmp($a,$b) {
return strcmp($a["fruit"],$b["fruit"]);
};
$fruit[0]["fruit"]="lemons";
$fruit[1]["fruit"]="apples";
$fruit[2]["fruit"]="grapes";
usort($fruit, "cmp");
while(list($key,$val)=each($fruit)) {
echo "$fruit[$key]:".$val["fruit"]."n";
}
При сортировке многомерных массивов
Будет напечатано:
$fruit[0]: apples$fruit[1]: grapes$fruit[2]: lemons
Если необходимо отсортировать массив с различными вторыми ключами, можно поступить следующим образом:
<?php
function arr_sort($a,$b) {
list($key1,$val)=each($a);
list($key2,$val)=each($b);
return strcmp($a[$key1],$b[$key2]);
};
$arr[0]["1-ый элемент"]="яблока";
$arr[1]["2-ый элемент"]="груша";
$arr[2]["3-ый элемент"]="персик";
$arr[3]["4-ый элемент"]="дыня";
$arr[4]["5-ый элемент"]="малина";
$arr[5]["6-ый элемент"]="ананас";
usort($arr,"arr_sort");
echo "<pre>";
print_r($arr);
echo "</pre>";
?>
Приведенный скрипт выведет следующее:
Array( [0] => Array ( [6-ый элемент] => ананас ) [1] => Array ( [2-ый элемент] => груша ) [2] => Array ( [4-ый элемент] => дыня ) [3] => Array ( [5-ый элемент] => малина ) [4] => Array ( [3-ый элемент] => персик ) [5] => Array ( [1-ый элемент] => яблока ))
Функция поддерживается PHP 3 =3.0.3, PHP 4, PHP 5
array_multisort
Сортировка нескольких массивов или многомерного массива.
Синтаксис:
bool array_multisort(array ar1, [, mixed arg [, mixed ... [, array ...]]])
Функция array_multisort() сортирует сразу несколько массивов или многомерные массивы с сохранением индексной ассоциации, возвращая true при отсутствии ошибок.
Исходные массивы рассматриваются как столбцы таблицы, сортируемой построчно. Поэтому массивы должны иметь одинаковое число элементов, и взаимосвязь между ними, как в строках таблицы, сохраняется. Приоритетом сортировки пользуются первые массивы. Флаги сортировки могут указваться для каждого массива, и их действие распространяется только на тот массив, после которого они указаны.
Флаги определения порядка сортировки:
Флаги типа сортировки:
Уазание несколько флагов сортировки после одного массива недопустимо. Флаги сортировки, которые переются после аргумента
Пример использования функции array_multisort():
Сортировка нескольких массивов
ar1 = array("10", 100, 100, "a");
ar2 = array(1, 3, "2", 1);
array_multisort($ar1, $ar2);
// $ar1 = array("10", "a", 100, 100);
// $ar2 = array(1, 1, "2", 3);
Элементы второго массива, соответствующие одинаковым элементам (100 и 100) первого массива, также отсортированны.
Сортировка многомерного массива
$ar = array(array("10", 100, 100, "a"), array(1, 3, "2", 1));
array_multisort($ar[0], SORT_ASC, SORT_STRING,
$ar[1], $SORT_NUMERIC, SORT_DESC);
// $ar[0] = ("10", 100, 100, "a") - сортируются как строки по возрастанию
// $ar[1] = (1, 3, "2", 1) - сортируются как числа по убыванию
Функция поддерживается PHP 4, PHP 5
Курсор массива
reset
Производит сброс курсора массива.
Синтаксис:
mixed reset(array arr)
Функция reset() устанавливает внутренний курсор массива arr на его начало и возвращает значение начального элемента.
Пример использования функции reset():
<?php
$array = array("step one", "step two", "step three", "step four");
// by default, the pointer is on the first element
echo current($array) . "<br />n"; // "step one"
// skip two steps
next($array);
next($array);
echo current($array) . "<br />n"; // "step three"
// reset pointer, start again on step one
reset($array);
echo current($array) . "<br />n"; // "step one"
?>
Функция поддерживается PHP 3, PHP 4, PHP 5
end
Производит перенос курсора в конец массива.
Синтаксис:
mixed end(array arr)
Функция end() устанавливает внутренний курсор массива arr на последний элемент и возвращает значение этого элемента.
Пример использования функции end():
<?php
$fruits = array("apple", "banana", "cranberry");
echo end($fruits); // cranberry
?>
Функция поддерживается PHP 3, PHP 4, PHP 5
next
Производит перенос курсора вперед.
Синтаксис:
mixed next(array arr)
Функция next() возвращает значение элемента, на котором в данный момент находится курсор, и перемещает курсор массива на следующий элемент. Возвращает
Также
Пример использования функции next():
<?php
$transport = array("foot", "bike", "car", "plane");
$mode = current($transport); // $mode = "foot";
$mode = next($transport); // $mode = "bike";
$mode = next($transport); // $mode = "car";
$mode = prev($transport); // $mode = "bike";
$mode = end($transport); // $mode = "plane";
?>
Функция поддерживается PHP 3, PHP 4, PHP 5
prev
Производит перенос курсора назад и возвращает предыдущее значени.
Синтаксис:
mixed prev(array arr)
Функция prev() перемещает курсор массива на предыдущий элемент и возвращает его значение. Возвращает
Также
Пример использования функции prev():
<?php
$transport = array("foot", "bike", "car", "plane");
$mode = current($transport); // $mode = "foot";
$mode = next($transport); // $mode = "bike";
$mode = next($transport); // $mode = "car";
$mode = prev($transport); // $mode = "bike";
$mode = end($transport); // $mode = "plane";
?>
Функция поддерживается PHP 3, PHP 4, PHP 5
current
Определение текущего элемента массива.
Синтаксис:
mixed current(array arr)
Каждый массив имеет внутренний указатель(курсор) текущего элемента. Обычно он указывает на первый элемент массива.
Функция current() возвращает значение элемента, на котором в данный момент находится курсор массива, при этом не сдвигая курсор.
Если указатель находиться за пределами массива, или массив пустой, то функция возвратит
Пример использования функции current():
<?php
$transport = array("foot", "bike", "car", "plane");
$mode = current($transport); // $mode = "foot";
$mode = next($transport); // $mode = "bike";
$mode = current($transport); // $mode = "bike";
$mode = prev($transport); // $mode = "foot";
$mode = end($transport); // $mode = "plane";
$mode = current($transport); // $mode = "plane";
?>
Функция поддерживается PHP 3, PHP 4, PHP 5
pos
Определение текущего элемента массива.
Синтаксис:
mixed pos(array arr)
Эта функция синоним функции current().
key
Функция возвращает индекс текущего элемента массива.
Синтаксис:
mixed key(array arr)
Функция key() возвращает индекс текущего элемента массива.
Пример использования функции key():
<?php
$array = array(
"fruit1" => "apple",
"fruit2" => "orange",
"fruit3" => "grape",
"fruit4" => "apple",
"fruit5" => "apple");
// этот цикл пройдется по всему массиву
// и выведет имя ключа элемента массива
// значение которого равно "apple"
while ($fruit_name = current($array)) {
if ($fruit_name == "apple") {
echo key($array)."*<br />";
}
next($array);
}
?>
Функция поддерживается PHP 3, PHP 4, PHP 5
each
Получение текущего элемента массива.
Синтаксис:
array each(array arr)
Функция each() возвращает пару"индекс и значение" текущего элемента массива, на который указывает внутренний курсор, и сдвигает курсор массива на следующий элемент.
Пример использования функции each():
<?php
$foo = array("bob", "fred", "jussi", "jouni", "egon", "marliese");
$bar = each($foo);
print_r($bar);
?>
Массив
Array( [1] => bob [value] => bob [0] => 0 [key] => 0)
<?php
$foo = array("Robert" => "Bob", "Seppo" => "Sepi");
$bar = each($foo);
print_r($bar);
?>
Массив
Array( [1] => Bob [value] => Bob [0] => Robert [key] => Robert)
Пример использования функции each():
Пролистывание массива
<?php
$fruit = array("a" => "apple", "b" => "banana", "c" => "cranberry");
reset($fruit);
while (list($key, $val) = each($fruit)) {
echo "$key => $valn";
}
?>
Пример выведет:
a => appleb => bananac => cranberry
Функция поддерживается PHP 3, PHP 4, PHP 5
array_walk
Применение пользовательской функции к элементам массива.
Синтаксис:
bool array_walk(array arr, callback function [, mixed userdata])
Функция array_walk() применяет пользовательскую функцию
В случае, если
Функция
В PHP 4 необходимо явно вызывать функцию reset(), чтобы установить внутренний курсор на первый элемент.
Пример использования функции array_walk():
<?php
$fruits = array("d" => "lemon", "a" => "orange", "b" => "banana", "c" => "apple");
function test_alter(&$item1, $key, $prefix)
{
$item1 = "$prefix: $item1";
}
function test_print($item2, $key)
{
echo "$key. $item2<br />n";
}
echo "Before ...:n";
array_walk($fruits, "test_print");
array_walk($fruits, "test_alter", "fruit");
echo "... and after:n";
array_walk($fruits, "test_print");
?>
Приведенный пример выведет следующее:
Before ...:d. lemona. orangeb. bananac. apple... and after:d. fruit: lemona. fruit: orangeb. fruit: bananac. fruit: apple
Функция поддерживается PHP 3 = 3.0.3, PHP 4, PHP 5
Ключи и значения
array_flip
Меняет местами индексы и значения массива.
Синтаксис:
array array_flip(array arr)
Эта функция "пробегает" по массиву и меняет местами его ключи и значения. Исходный массив arr не изменяется, а результирующий массив просто возвращается. Если в массиве присутствовало несколько элементов с одинаковыми значениями, учитываться будет только последний из них.
Значения массива
Функция array_flip() возвратит
Пример использования функции array_flip():
$trans = array_flip ($trans);
$original = strtr ($str, $trans);
Пример использования функции array_flip():
многократное повторение значения
<php
$trans = array ("a" => 1, "b" => 1, "c" => 2);
$trans = array_flip ($trans);
print_r($trans);
Приведенный выше пример выведет следующее:
Array( [1] => b [2] => c)
Функция поддерживается PHP 4, PHP 5
array_keys
Возвращает список из ключей массива.
Синтаксис:
array array_keys(array arr [,mixed search_value])
Функция возвращает массив, значениями которого являются все строковые и числовые ключи массива
Пример испольльзования функции array_keys():
<?php
$arr = array(0 => 100, "color" => "red", 15);
print_r(array_keys($arr));
$arr = array("blue", "red", "green", "blue", "blue");
print_r(array_keys($arr, "blue"));
$array = array ("color" => array("blue", "red", "green"), "size" => array("small", "medium", "large"));
print_r(array_keys ($array));
?>
Приведенный выше пример выведет следующее:
Array( [0] => 0 [1] => color)Array( [0] => 0 [1] => 3 [2] => 4)Array( [0] => color [1] => size)
Функция array_keys() появилась в PHP 4.
Ее эквивалент для PHP 3:
function array_keys ($arr, $term="") {
$t = array();
while (list($k,$v) = each($arr)) {
if ($term && $v != $term) {
continue;
}
$t[] = $k;
}
return $t;
}
Функция поддерживается PHP 4, PHP 5
array_values
Удаление ассоциативных индексов массива.
Синтаксис:
array array_values(array arr)
Функция array_values() возвращает список всех значений в ассоциативном массиве arr. При этом она заменяет все строковые ключи на числовые.
Пример использования функции array_values():
$arr = array("size" => "XL", "color" => "gold");
print_r(array_values($arr));
Этот пример выведет:
Array( [0] => XL [1] => gold)
Функция поддерживается PHP 4, PHP 5
in_array
Осуществляет проверку массива на наличие значения.
Синтаксис:
bool in_array ( mixed needle, array haystack [, bool strict])
Функция in_array() возвратит
Если установить третий необязательный параметр
Замечание: Если параметр
Замечание: В PHP версии ниже 4.2.0 параметр
Пример использования функции in_array():
<?php
$os = array("Mac", "NT", "Irix", "Linux");
if (in_array("Irix", $os)) {
echo "Got Irix";
}
if (in_array("mac", $os)) {
echo "Got mac";
}
?>
Второе условие не сработает, т.к. поиск в массиве идет с учетом регистра.
Пример выведет:
Got Irix
Пример использования функции in_array(): Использование параметра
<?php
$a = array(array("p", "h"), array("p", "r"), "o");
if (in_array(array("p", "h"), $a)) {
echo "ph was foundn";
}
if (in_array(array("f", "i"), $a)) {
echo "fi was foundn";
}
if (in_array("o", $a)) {
echo "o was foundn";
}
?>
Пример выведет:
ph was found o was found
Функция поддерживается PHP 4, PHP 5
array_count_values
Возвращает количество значений массива.
Синтаксис:
array array_count_values(array arr)
Эта функция подсчитывает, сколько раз каждое значение встречается в массиве
Пример использования функции array_count_values():
$arr = array(1, "hello", 1, "world", "hello");
print_r(array_count_values($arr));
Пример выведет следующее:
Array( [1] => 2 [hello] => 2 [world] => 1)
Функция поддерживается PHP 4, PHP 5
sizeof
Возвращает число элементов массива.
Синтаксис:
int sizeof(array arr)
Функция sizeof() возвращает количество элементов в массиве
count
Возвращает число элементов в массиве или объекте.
Синтаксис:
int count(mixed var [, int mode])
Функция count() возвращает число элементов в массиве или объекте
Надо отметить, что 0 возвращается и тогда, когда указан массив, не содержащий элементов (NULL).
Если задан необязательный параметр mode, то будет подсчитано общее количество элементов в массиве. Это может быть полезно при нахождении количества элементов в многомерных массивах.
Пример использования функции count():
<?php
$a[0] = 1;
$a[1] = 3;
$a[2] = 5;
$result = count($a);
// $result == 3
$b[0] = 7;
$b[5] = 9;
$b[10] = 11;
$result = count($b);
// $result == 3;
?>
Пример использования функции count(): (PHP = 4.2.0)
<?php
$food = array("fruits" => array("orange", "banana", "apple"),
"veggie" => array("carrot", "collard", "pea"));
// recursive count
echo count($food, COUNT_RECURSIVE); // выведет 8
// normal count
echo count($food); // выведет 2
?>
Функция поддерживается PHP 3, PHP 4, PHP 5
array_sum
Возвращает сумму всех элементов массива.
Синтаксис:
mixed array_sum(array arr)
Функция array_sum() возвращает сумму всех числовых элементов массива. От типа значений в массиве зависит тип возвращаемого числа (integer или float).
Пример использования функции array_sum():
<?php
$a = array(2, 4, 6, 8);
echo "sum(a) = " . array_sum($a) . "<BR>";
$b = array("a" => 1.2, "b" => 2.3, "c" => 3.4);
echo "sum(b) = " . array_sum($b) . "<BR>";
?>
Этот пример выведет следующее:
sum(a) = 20sum(b) = 6.9
Функция поддерживается PHP 4 =4.0.4, PHP 5
array_rand
Производит случайную выборку индексов массива.
Синтаксис:
mixed array_rand(array arr [, int num_req])
Функция array_rand() будет полезной, если вы хотите выбрать одно или несколько случайных значений из массива. Эта функция возвращает в массиве выбранные случайным образом индексы элементов массива
Аргумент
Пример использования функции array_rand():
<?php
srand((double)microtime() *1000000);
// здесь мы проинициализировали генератор случайных чисел
$arr = array("Neo", "Morpheus", "Trinity", "Cypher", "Tank");
$rand_keys = array_rand($arr, 2);
echo $arr[$rand_key[0]]."<BR>";
echo $arr[$rand_key[1]]."<BR>";
?>
Функция поддерживается PHP 4, PHP 5
array_change_key_case
Функция устанавливает значения ключей массива в верхний или нижний регистр.
Синтаксис:
array array_change_key_case(array arr[, int registr])
Функция array_change_key_case() возвращает исходный массив
Необязательный параметр
Данная функция не изменяет ключи, состоящие из чисел.
Пример использования функции array_change_key_case():
$array = array("FirSt" => 1, "SecOnd" => 4);
print_r(array_change_key_case($array, CASE_UPPER));
print_r(array_change_key_case($array, CASE_LOWER));
Пример выведет следующее:
Array
(
[FIRST] => 1
[SECOND] => 2
)
Array
(
[first] => 1
[second] => 2
)
Функция поддерживается PHP 4 = 4.2.0, PHP 5
array_combine
Функция объединяет два массива, причем значения первого становяться ключами, а значения второго - значениями.
Синтаксис:
array array_combine(array keys, array values)
Функция array_combine() возвращает массив, ключами которого являются значения массива
Функция возвратит
Пример использования функции array_combine():
<?php
$a = array("green", "red", "yellow");
$b = array("avocado", "apple", "banana");
$c = array_combine($a, $b);
print_r($c);
?>
Пример выведет следующее:
Array( [green] => avocado [red] => apple [yellow] => banana)
Функция поддерживается PHP 5
array_key_exists
Проверка существования заданного ключа в массиве.
Синтаксис:
bool array_key_exists(mixed key, array search)
Функция array_key_exists() возвратит
В противном случае возвратит
Пример использования функции array_key_exists():
<?php
$search_array = array("first" => 1, "second" => 4);
if (array_key_exists("first", $search_array)) {
echo "The <I>first</I> element is in the array";
}
?>
В PHP 4.0.6. имя этой функции key_exists().
Функция поддерживается PHP 4 = 4.0.1, PHP 5
Работа с несколькими массивами
array_diff
Определение исключительного пересечения массивов.
Синтаксис:
array array_diff(array arr1, array arr2 [, array ...])
Данная функция возвращает массив, который содержит значения, имеющиеся только в массиве
$arr1 = array("a" => "green", "red", "blue", "red");
$arr2 = array("b" => "green", "yellow", "red");
$result = array_diff($arr1, $arr2);
// $result = array("blue")
Повторение одного и того же значения "red" в массиве
Стоит отметить, что два элемента считаются одинаковыми, только если их строковое представление идентично. Т.е.
Также стоит отметить, что данная функция корректно обрабатывает только одно измерение N-мерного массива. Если есть необходимость обрабатывать более глубокие уровни вложенности, можно использовать конструкцию
Функция поддерживается PHP 4 = 4.0.1, PHP 5
array_diff_assoc
Определение исключительного пересечения массивов с учетом индексов массивов.
Синтаксис:
array array_diff_assoc(array arr1, array arr2 [, array ...])
Данная функция возвращает массив, который содержит значения, имеющиеся только в массиве
Пример использования array_diff_assoc():
<?php
$array1 = array("a" => "green", "b" => "brown", "c" => "blue", "red");
$array2 = array("a" => "green", "yellow", "red");
$result = array_diff_assoc($array1, $array2);
print_r($result);
?>
Пример выведет следующее:
Array( [b] => brown [c] => blue [0] => red)
В приведенном примере пара "a" = "green" присутствует в обоих массивах, поэтому она не вошла в результирующий массив. В отличие от этого, значение
Две пары ключ = значение считаются равными, если они тождественны друг другу, т.е.
Обратите внимание, что данная функция не позволяет напрямую сравнивать многомерные массивы. Хотя конечно можно сравнить вложенные массивы, используя, например,
Функция поддерживается PHP 4 =4.3.0, PHP 5
array_diff_uassoc
Определение различия между массивами при помощи пользовательской функции с дополнительной проверкой ключей массива.
Синтаксис:
array array_diff_uassoc(array arr1, array arr2 [, array ..., callback key_compare_func])
Функция array_diff_uassoc() возвращает массив, который содержит значения, имеющиеся только в массиве arr1 ( и не имеющиеся в любых других).
Обратите внимание, что в отличии от функции array_diff(), при сравнении учитываются ключи. Сделано это при помощи пользовательской функции
Пример использования array_diff_uassoc():
<?php
function key_compare_func($a, $b)
{
if ($a === $b) {
return 0;
}
return ($a > $b)? 1:-1;
}
$array1 = array("a" => "green", "b" => "brown", "c" => "blue", "red");
$array2 = array("a" => "green", "yellow", "red");
$result = array_diff_uassoc($array1, $array2, "key_compare_func");
?>
Пример выведет следующее:
Array( [b] => brown [c] => blue [0] => red)
В приведенном примере пара "a" = "green" присутствует в обоих массивах, поэтому она не вошла в результирующий массив. В отличие от этого, значение red присутствует в результирующем массиве, т.к. в первом массиве это значение имело ключ 0, а во втором массиве оно имело ключ 1.
Равенство индексов проверяется пользовательской функцией.
Обратите внимание, что данная функция не позволяет напрямую сравнивать многомерные массивы. Хотя конечно можно сравнить вложенные массивы, используя, например,
Функция поддерживается PHP 5
array_udiff
Сравнивает массивы используя пользовательскую функцию.
Синтаксис:
array array_udiff( array array1, array array2 [, array ..., callback data_compare_func])
Функция array_udiff() возвращает массив, содержащий все значения массива
Стоит отметить, что ключи значений сохраняются.
Для сравнения значений массивов используется пользовательская функция
<?php
class cr {
private $priv_member;
function cr($val)
{
$this->priv_member = $val;
}
function comp_func_cr($a, $b)
{
if ($a->priv_member === $b->priv_member) return 0;
return ($a->priv_member > $b->priv_member)? 1:-1;
}
}
$a = array("0.1" => new cr(9), "0.5" => new cr(12), 0 => new cr(23), 1=> new cr(4), 2 => new cr(-15),);
$b = array("0.2" => new cr(9), "0.5" => new cr(22), 0 => new cr(3), 1=> new cr(4), 2 => new cr(-15),);
$result = array_udiff($a, $b, array("cr", "comp_func_cr"));
print_r($result);
?>
Этот пример выведет следующее:
Array( [0.5] => cr Object ( [priv_member:private] => 12 ) [0] => cr Object ( [priv_member:private] => 23 ))
Два значения будут сочтены равными, только если
Стоит отметить, что данная функция в случае многомерного массива использует для сравнения одного измерение. Если вы хотите пройтись по всем измерениям, стоит использовать конструкцию
Функция поддерживается PHP 5
array_udiff_assoc
Сравнивает массивы используя пользовательскую функцию.
Синтаксис:
array array_udiff_assoc( array array1, array array2 [, array ..., callback data_compare_func])
Функция array_udiff_assoc() возвращает массив, содержащий все значения массива
Для сравнения значений массивов используется пользовательская функция. Этим данная функция отличается от array_diff_assoc(), которая использует внутреннюю функции для сравнения.
Пример использования функции array_udiff_assoc():
<?php
class cr {
private $priv_member;
function cr($val)
{
$this->priv_member = $val;
}
function comp_func_cr($a, $b)
{
if ($a->priv_member === $b->priv_member) return 0;
return ($a->priv_member > $b->priv_member)? 1:-1;
}
}
$a = array("0.1" => new cr(9), "0.5" => new cr(12), 0 => new cr(23), 1=> new cr(4), 2 => new cr(-15),);
$b = array("0.2" => new cr(9), "0.5" => new cr(22), 0 => new cr(3), 1=> new cr(4), 2 => new cr(-15),);
$result = array_udiff_assoc($a, $b, array("cr", "comp_func_cr"));
print_r($result);
?>
Этот пример выведет следующее:
Array( [0.1] => cr Object ( [priv_member:private] => 9 ) [0.5] => cr Object ( [priv_member:private] => 12 ) [0] => cr Object ( [priv_member:private] => 23 ))
В нашем примере пара
Для сравнения используется пользовательская функция. Она возвращает значение, меньшее нуля, равное нулю или большее нуля, если переданный ей первый параметр меньше второго, равен второму или больше второго соответственно.
Функция поддерживается PHP 5
array_udiff_uassoc
Сравнивает массивы используя пользовательскую функцию.
Синтаксис:
array array_udiff_uassoc ( array array1, array array2 [, array ..., callback data_compare_func, callback key_compare_func])
Функция array_udiff_uassoc() возвращает массив, содержащий все значения массива
Для сравнения значений массивов используется пользовательская функция
Сравнение ключей (индексов) происходит при помощи пользовательской функции
Пример использования функции array_udiff_uassoc():
<?php
class cr {
private $priv_member;
function cr($val)
{
$this->priv_member = $val;
}
function comp_func_cr($a, $b)
{
if ($a->priv_member === $b->priv_member) return 0;
return ($a->priv_member > $b->priv_member)? 1:-1;
}
function comp_func_key($a, $b)
{
if ($a === $b) return 0;
return ($a > $b)? 1:-1;
}
}
$a = array("0.1" => new cr(9), "0.5" => new cr(12), 0 => new cr(23), 1=> new cr(4), 2 => new cr(-15),);
$b = array("0.2" => new cr(9), "0.5" => new cr(22), 0 => new cr(3), 1=> new cr(4), 2 => new cr(-15),);
$result = array_udiff_uassoc($a, $b, array("cr", "comp_func_cr"), array("cr", "comp_func_key"));
print_r($result);
?>
Этот пример выведет следующее:
Array( [0.1] => cr Object ( [priv_member:private] => 9 ) [0.5] => cr Object ( [priv_member:private] => 12 ) [0] => cr Object ( [priv_member:private] => 23 ))
В нашем примере пара
Для сравнения используется пользовательская функция. Она возвращает значение, меньшее нуля, равное нулю или большее нуля, если переданный ей первый параметр меньше второго, равен второму или больше второго соответственно.
Функция поддерживается PHP 5
array_intersect
Определение включительного пересечения массивов.
Синтаксис:
array array_intersect(array arr1, array arr2 [, array ...])
Функция array_intersect() возвращает массив, который содержит значения массива
Пример использования функции array_intersect():
<?php
$arr1 = array("a" => "green", "red", "blue");
$arr2 = array("b" => "green", "yellow", "red");
$result = array_intersect($arr1, $arr2);
print_r($result);
?>
Пример выведет:
Array( [a] => green [0] => red)
Функция поддерживается PHP 4 = 4.0.1, PHP 5
array_intersect_assoc
Функция возвращает пересечения значений массивов с сохранением индексов.
Синтаксис:
array array_intersect_assoc(array array1, array array2 [, array ...])
Функция array_intersect_assoc() возвращает массив, который содержит все значения
Пример использования функции array_intersect_assoc():
<?php
$array1 = array("a" => "яблоко", "b" => "груша", "c" => "дыня", "слива");
$array2 = array("a" => "яблоко", "апельсин", "слива");
$result_array = array_intersect_assoc($array1, $array2);
?>
Пример выведет следующее:
Array( [a] => яблоко)
Приведенный пример вывел только значение
Значение дыня не выведено, т.к. в первом массиве у него был индекс 0, а во втором - 1
Функция поддерживается PHP 4 = 4.3.0, PHP 5
array_merge
Слияние массивов.
Синтаксис:
array array_merge(array arr1, array arr2 [, array ...])
Функция array_merge() призвана устранить все недостатки, присущие оператору + для слияния массивов. А именно, она сливает массивы, перечисленные в ее аргументах, в оди большой массив и возвращает результат. Т.е. значени одного массива присоединяются к значениям предыдущего.
Если в массивах встречаются одинаковые строковые ключи, то тогда значения, принадлежащие этим ключам, сливаются в один массив таким образом, чтобы если одно из значений в свою очередь является массивом, функция array_merge() сливает его с соответствующим значением в другом массиве.
Однако это не затрагивает числовые ключи: элементы с такими ключами помещаются в конец результирующего массива в любом случае.
Пример использования функции array_merge():
<?php
$array1 = array ("color" => "red", 2, 4);
$array2 = array ("a", "b", "color" => "green", "shape" => "trapezoid", 4);
$result = array_merge ($array1, $array2);
print_r($result);
?>
Пример выведет следующее:
Array( [color] => green [0] => 2 [1] => 4 [2] => a [3] => b [shape] => trapezoid [4] => 4)
Другой пример использования функции array_merge():
<?php
$array1 = array();
$array2 = array(1 => "data");
$result = array_merge($array1, $array2);
print_r($result);
?>
Пример выведет следующее:
Array( [0] => data)
Стоит отметить, что числовые ключи были потеряны.
Если есть необходимость просто слить массивы вместе, используйте оператор +
<?php
$array1 = array();
$array2 = array(1 => "data");
$result = $array1 + $array2;
print_r($result);
?>
Пример выведет следующее:
Array( [1] => data)
Функция поддерживается PHP 4, PHP 5
array_merge_recursive
Рекурсивное слияние сложных массивов.
Синтаксис:
array array_merge_recursive(array arr1, array arr2 [, array ...])
Функция array_merge_recursive() объединяет элементы массивов, переданных в ее параметрах таким образом, что значения одного массива присоединяются к значениям предудущих.
Функция возвращает массив, состоящий из объединенных массивов.
Если массивы, переданные в параметрах этой функции, имеют одинаковые строковые ключи, тогда значения, соответствующие этим ключам, сливаются в один массив. При этом если одно из значений само является массивом, то оно будет слито с соответствующим значением в другом массиве.
Но если в массивах присутствуют одинаковые числовые ключи, то тогда значение такого ключа, упомянутое последним, не заменит исходное значение, а будет слито с ним.
Пример использования функции array_merge_recursive():
<?php
$arr1 = array("color" => array("favorite" =>"red"), 5);
$arr2 = array(10, "color" => array("favorite" =>"green", "blue"));
$result = array_merge_recursive($arr1, $arr2);
print_r($result_;
?>
Пример выведет:
Array( [color] => Array ( [favorite] => Array ( [0] => red [1] => green ) [0] => blue ) [0] => 5 [1] => 10)
Функция поддерживается PHP 4 =, PHP 5
Получение и удаление части массива
array_slice
Получение части массива.
Синтаксис:
array array_slice(array arr, int offset [, int lenght])
Функция array_slice() возвращает часть ассоциативного массива
Параметры
Если указать length>0, то это число возвращаемых в массиве элементов, а если length<0, то это позиция последнего возвращаемого элемента в массиве
Пример использования функции array_slice():
<?php
$input = array("a", "b", "c", "d", "e");
$output = array_slice($input, 2); // "c", "d", "e"
$output = array_slice($input, 2, -1); // "c", "d"
$output = array_slice($input, -2, 1); // "d"
$output = array_slice($input, 0, 3); // "a", "b", "c"
?>
Функция поддерживается PHP 4, PHP 5
array_splice
Удаляет часть массива или заменяет ее частью другого массива.
Синтаксис:
array array_splice(array arr, int offset [, int lenght [, int replacement]])
Функция array_splice(), также как и array_slice(), возвращает подмасcив
Если offset>0, то последовательность будет начинаться с элемента, имеющего позицию
Если указать length>0, то это число возвращаемых в массиве элементов, а если length<0, то это позиция последнего возвращаемого элемента в массиве
В качестве примера укажем следующие эквивалентыне замены:
array_push($input, $x, $y) array_splice($input, count($input), 0, array($x, $y))
array_pop($input) array_splice($input, -1)
array_shift($input) array_splice($input, -1)
array_unshift($input, $x, $y) array_splice($input, 0, 0, array($x, $y))
$a[$x] = $y array_splice($input, $x, 1, $y)
Пример использования функции array_splice():
<?php
$input = array("red", "green", "blue", "yellow");
array_splice($input, 2);
// $input is now array("red", "green")
$input = array("red", "green", "blue", "yellow");
array_splice($input, 1, -1);
// $input is now array("red", "yellow")
$input = array("red", "green", "blue", "yellow");
array_splice($input, 1, count($input), "orange");
// $input is now array("red", "orange")
$input = array("red", "green", "blue", "yellow");
array_splice($input, -1, 1, array("black", "maroon"));
// $input is now array("red", "green",
// "blue", "black", "maroon")
$input = array("red", "green", "blue", "yellow");
array_splice($input, 3, 0, "purple");
// $input is now array("red", "green",
// "blue", "purple", "yellow");
?>
Функция поддерживается PHP 4, PHP 5
Вставка / удаление элементов
array_pad
Добавляет в массив несколько элементов.
Синтаксис:
array array_pad(array input, int pad_size, mixed pad_value)
Функция array_pad() возвращает копию массива
Если pad_size0, то элементы будут добавлены в конец массива, а если <0 - то в начало.
В случае, если значение
Пример использования функции array_pad():
$arr = array(12, 10, 4);
$result = array_pad($arr, 5, 0);
// $result = array(12, 10, 4, 0, 0);
$result = array_pad($arr, -7, -1);
// $result = array(-1, -1, -1, -1, 12, 10, 4)
$result = array_pad($arr, 2, "noop");
// не добавит
Функция поддерживается PHP 4, PHP 5
array_pop
Извлекает и удаляет последние элементы массива.
Синтаксис:
mixed array_pop(array arr);
Функция array_pop() извлекает последний элемент из массива
После использования функции array_pop() курсор массива устанавливается в начало.
Пример использования функции array_pop():
<?php
$stack = array("orange", "apple", "raspberry");
$fruits = array_pop($stack);
print_r($stack);
print_r($fruits);
?>
Пример выведет следующее:
Array( [0] => orange [1] => banana [2] => apple)
Функция поддерживается PHP 4, PHP 5
array_push
Добавляет один или несколько элементов в конец массива.
Синтаксис:
int array_push(array arr, mixed var1 [, mixed var2, ..])
Функция array_push() добавляет к массиву
array_push($Arr,1000); // вызываем функцию
$Arr[]=100; // то же самое, но короче
Пример использования функции array_push():
<?php
$stack = array("orange", "banana");
array_push($stack, "apple", "raspberry");
print_r($stack);
?>
Пример выведет следующее:
Array( [0] => orange [1] => banana [2] => apple [3] => raspberry)
Обратите внимание, что функция array_push() воспринимает массив, как стек, и добавляет элементы всегда в его конец.
Функция поддерживается PHP 4, PHP 5
array_shift
Извлекает и удаляет первый элемент массива.
Синтаксис:
mixed array_shift(array arr)
Функция array_shift() извлекает первый элемент массива arr и возвращает его. Она сильно напоминает array_pop(), но только получает начальный, а не конечный элемент, а также производит довольно сильную "встряску" всего массива: ведь при извлечении первого элемента приходится корректировать все числовые индексы у всех оставшихся элементов, т.к. все последующие элементы массива сдвигаются на одну позицию вперед. Строковые ключи массива не изменяются.
Если массив
После использования этой функции указатель массива становится в начало.
Пример использования функции array_shift():
<?php
$stack = array("orange", "banana", "apple", "raspberry");
$fruit = array_shift($stack);
print_r($stack);
?>
Данный пример выведет следующее:
Array( [0] => banana [1] => apple [2] => raspberry)
а переменная
Функция поддерживается PHP 4, PHP 5
array_unshift
Добавляет одно или несколько значений в начало массива.
Синтаксис:
int array_unshift(list arr, mixed var1 [,mixed var2, ...])
Функция array_unshift() добавляет переданные значения
Функция возвращает новое количество элементов в массиве.
Пример использования функции array_unshift():
<?php
$queue = array("orange", "banana");
array_unshift($queue, "apple", "raspberry");
?>
Теперь переменная
Array( [0] => apple [1] => raspberry [2] => orange [3] => banana)
Функция поддерживается PHP 4, PHP 5
array_unique
Удаляет дублирующие значения в массиве.
Синтаксис:
array array_unique(array arr)
Функция array_unique() возвращает массив, составленный из всех уникальных значений массива
Пример использования функции array_unique():
<?php
$input = array("a" => "green", "red", "b" =>
"green", "blue", "red");
$result = array_unique($input);
print_r($result);
?>
Пример выведет следующее:
Array( [a] => green [0] => red [1] => blue)
Пример использования функции array_unique(): Сравнение типов данных
<?php
$input = array(4, "4", "3", 4, 3, "3");
$result = array_unique($input);
var_dump($result);
?>
Пример выведет следующее:
array(2) { [0] => int(4) [2] => string(1) "3"}
Функция поддерживается PHP 4 >= 4.0.1, PHP 5
array_chunk
Функция разбивает массив на части.
Синтаксис:
array array_chunk(array arr, int size [, bool preserve_keys])
Функция array_chunk() разбивает исходный массив
Функция array_chunk() возвращает многомерный массив, индексами которого начинаются от 0 и до кол-ва полученных массивов, а значения - полученные в результате разбивки массивы.
Необязательный параметр
Пример использования функции array_chunk():
$array = array("1-ый элемент",
"2-ой элемент",
"3-ий элемент",
"4-ый элемент",
"5-ый элемент");
print_r(array_chunk($array, 2));
print_r(array_chunk($array, 2, TRUE));
Пример выведет следующее:
Array( [0] => Array ( [0] => 1-ый элемент [1] => 2-ой элемент ) [1] => Array ( [0] => 3-ий элемент [1] => 4-ый элемент ) [2] => Array ( [0] => 5-ый элемент ))Array( [0] => Array ( [0] => 1-ый элемент [1] => 2-ой элемент ) [1] => Array ( [2] => 3-ий элемент [3] => 4-ый элемент ) [2] => Array ( [4] => 5-ый элемент ))
Функция поддерживается PHP 4 >= 4.2.0, PHP 5
array_fill
Функция заполняет массив определенными значениями.
Синтаксис:
array array_fill(int start_index, int num, mixed value)
Функция array_fill() возвращает массив, который содержит значения, указанные в параметре
Пример использования array_diff_uassoc():
<?php
$a = array_fill(5, 6, 'banana');
print_r($a);
?>
Пример выведет следующее:
Array( [5] => banana [6] => banana [7] => banana [8] => banana [9] => banana [10] => banana)
Функция поддерживается PHP 4 >= 4.2.0, PHP 5
array_filter
Функция применяет фильтр к массиву, используя пользовательскую функцию.
Синтаксис:
array array_filter(array input [, callback callback])
Функция array_filter() возвращает массив, который содержит значения, имеющиеся в массиве
В случае, если исходный массив
Пример использования функции array_filter():
<?php
function odd($var) {
return ($var % 2 == 1);
}
function even($var) {
return ($var % 2 == 0);
}
$array1 = array ("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5);
$array2 = array (6, 7, 8, 9, 10, 11, 12);
echo "Нечетные :n";
print_r(array_filter($array1, "odd"));
echo "Четные :n";
print_r(array_filter($array2, "even"));
?>
Пример выведет следующее:
Нечетные :Array( [a] => 1 [c] => 3 [e] => 5)Четные :Array( [0] => 6 [2] => 8 [4] => 10 [6] => 12)
Стоит отметить, что вместо имени фильтрующей функции можно указать массив, который содержит ссылку на объект и имя метода.
Также стоит отметить, что при обработке массива фукцией array_filter() его нельзя изменять: добавлять, удалять элементы или обнулять массив, т.к. это может привести к некоррекстной работе функции.
Функция поддерживается PHP 4 >= 4.0.6, PHP 5
array_map
Применение пользовательской функции ко всем элементам указанных массивов.
Синтаксис:
array array_map(mixed callback, array arr1 [, array ...])
Функция array_map() возвращает массив, который содержит элементы всех указанных массивов после обработки пользовательской функцией
Количество параметров, передаваемых пользовательской функции, должно совпадать с количеством массивов, переданных функции array_map().
Пример испольльзования функции array_map(): Обработка одного массива
<?php
function cube($n) {
return $n*$n*$n;
}
$a = array(1, 2, 3, 4, 5);
$b = array_map("cube", $a);
print_r($b);
?>
Приведенный пример выведет следующее:
Array( [0] => 1 [1] => 8 [2] => 27 [3] => 64 [4] => 125)
Пример испольльзования функции array_map(): Обработка нескольких массивов
<?php
function show_Spanish($n, $m) {
return "Число $n по-испански - $m";
}
function map_Spanish($n, $m) {
return array ($n => $m);
}
$a = array(1, 2, 3, 4, 5);
$b = array("uno", "dos", "tres", "cuatro", "cinco");
$c = array_map("show_Spanish", $a, $b);
print_r($c);
$d = array_map("map_Spanish", $a , $b);
print_r($d);
?>
Приведенный пример выведет следующее:
// printout of $cArray( [0] => Число 1 по-испански - uno [1] => Число 2 по-испански - dos [2] => Число 3 по-испански - tres [3] => Число 4 по-испански - cuatro [4] => Число 5 по-испански - cinco)// printout of $dArray( [0] => Array ( [1] => uno ) [1] => Array ( [2] => dos ) [2] => Array ( [3] => tres ) [3] => Array ( [4] => cuatro ) [4] => Array ( [5] => cinco ))
Обычно функцию array_map() применяют к массивам, имеющим одинаковую размерность. Если массивы имеют разную длину, то меньшие из них дополняются элементами с пустыми значениями.
Следует отметить, что если вместо имени обрабатывающей функции задать
Пример испольльзования функции array_map(): Создание массива массивов
<?php
$a = array(1, 2, 3, 4, 5);
$b = array("one", "two", "three", "four", "five");
$c = array("uno", "dos", "tres", "cuatro", "cinco");
$d = array_map(null, $a, $b, $c);
print_r($d);
?>
Приведенный пример выведет следующее:
Array( [0] => Array ( [0] => 1 [1] => one [2] => uno ) [1] => Array ( [0] => 2 [1] => two [2] => dos ) [2] => Array ( [0] => 3 [1] => three [2] => tres ) [3] => Array ( [0] => 4 [1] => four [2] => cuatro ) [4] => Array ( [0] => 5 [1] => five [2] => cinco ))
Функция поддерживается PHP 4 >= 4.0.6, PHP 5
Переменные и массивы
list
Заносит элементы массива в переменные.
Синтаксис:
void list ( mixed ...)
Наподобие array(), функция list() не совсем функция, а языковая конструкция. Она используется для формирования списка переменных.
Замечание: list() работает только с цифровыми индексами массива и принимает ключи элементов начиная с 0.
Пример использования функции list():
<?php
$info = array("coffee", "brown", "caffeine");
// Выведем все переменные
list($drink, $color, $power) = $info;
echo "$drink is $color and $power makes it special.n";
// Выведем первый и последний
list($drink, , $power) = $info;
echo "$drink has $power.n";
// Выведем только третий
list( , , $power) = $info;
echo "I need $power!n";
?>
Пример использования функции list():
<table>
<tr>
<th>Employee name</th>
<th>Salary</th>
</tr>
<?php
$result = mysql_query("SELECT id, name, salary FROM employees", $conn);
while (list($id, $name, $salary) = mysql_fetch_row($result)) {
echo " <tr>n" .
" <td><a href="info.php?id=$id">$name</a></td>n" .
" <td>$salary</td>n" .
" </tr>n";
}
?>
</table>
Пример использования функции list(): Индексы
<?php
$info = array("coffee", "brown", "caffeine");
list($a[0], $a[1], $a[2]) = $info;
var_dump($a);
?>
array(3) { [2]=> string(8) "caffeine" [1]=> string(5) "brown" [0]=> string(6) "coffee"}
Функция поддерживается PHP 3, PHP 4, PHP 5
compact
Упаковывает в массив переменные из текущего контекста.
Синтаксис:
array compact(mixed varname1 [, mixed $varname2, ...])
Функция compact() упаковывает в массив переменные из текущего контекста (глобального или контекста функции), заданные своими именами в
Число аргументов может быть неопределенное.
Если в аргументе указано имя несуществующей переменной, он пропускается. Действие этой функции противоположно функции extract().
Пример использования функции compact():
<?php
$city = "San Francisco";
$state = "CA";
$event = "SIGGRAPH"";
$location_vars = array("city", "state");
$result = compact("event", "nothing_here", $location_vars);
?>
В результате выполнения кода переменная
Array( [event] => SIGGRAPH [city] => San Francisco [state] => CA)
Почему же тогда параметры функции обозначены как
Пример использования функции compact():
<?php
$a="Test";
$b="Text";
$c="CCC";
$d="DDD";
$List=array("b",array("c","d"));
$A=compact("a",$List);
?>
Теперь:
// теперь $A===array("a"=>"Test", "b"=>"Text",
"c"=>"CCC", "d"=>"DDD")
Функция поддерживается PHP 4, PHP 5
extract
Импорт элементов массива в переменные.
Синтаксис:
int extract (array var_array [, int extract_type [, string prefix]])
Функция extract() используется для импортирования значений массива в строку. Эта функция берет ассоциативный массив
Замечание: начиная с PHP версии 4.0.5 эта функция возвращала количество извлеченных переменных.
Функция extract() проверяет, действительно ли каждый ключ массива может быть названием переменной. Она также проверяет на наличие одинаковых названий получаемых переменных. В случае, если обнаруживаются недействительные или числовые ключи, поведение функции предопределяет параметр
Пример использования функции extract():
<?php
/* Предположим, что $var_array массив,
полученный при помощи функции wddx_deserialize */
$size = "large";
$var_array = array("color" => "blue",
"size" => ""medium",
"shape" => "sphere");
extract($var_array, EXTR_PREFIX_SAME, "wddx");
echo "$color, $size, $shape, $wddx_sizen";
?>
Пример выведет:
blue, large, sphere, medium
Здесь переменная
Лучше всего использовать ассоциативные массивы. Массивы с цифровыми ключами не могут быть использованы в этой функции, если установлены флаги
Функция поддерживается PHP 3 = 3.0.7, PHP 4, PHP 5
Строковые функции
chr
Возвращает один символ с определенным кодом.
Синтаксис:
string chr(int ascii)
Возвращает строку из одного символа с кодом
<?
// Сначало создаем массив того, что мы собираемся выводить,
// не заботясь о форматировании (дизайне) информации
for($i=0, $x=0; $x<16; $x++) {
for($y=0; $y<16; $y++) {
$Chars[$x][$y]=array($i,chr($i));
$i++;
}
}
// Теперь выводим накопленную информацию, используя идеологию
// вставки участков кода в HTML-документ
?>
<table border=1 cellpadding=1 cellspacing=0>
<?for($y=0; $y<16; $y++) {?>
<tr>
<?for($x=0; $x<16; $x++) {?>
<td>
<?=$Chars[$x][$y][0]?>:
<b><tt><?=$Chars[$x][$y][1]?></tt></b>
</td>
<?}?>
</tr>
<?}?>
</table>
ord
Возвращает ascii код символа.
Синтаксис:
int ord(string str)
Эта функция возвращает ASCII код первого символа строки
Функции для работы с одиночными символами
chr
Возвращает один символ с определенным кодом.
Синтаксис:
string chr(int ascii)
Возвращает строку из одного символа с кодом
<?
// Сначало создаем массив того, что мы собираемся выводить,
// не заботясь о форматировании (дизайне) информации
for($i=0, $x=0; $x<16; $x++) {
for($y=0; $y<16; $y++) {
$Chars[$x][$y]=array($i,chr($i));
$i++;
}
}
// Теперь выводим накопленную информацию, используя идеологию
// вставки участков кода в HTML-документ
?>
<table border=1 cellpadding=1 cellspacing=0>
<?for($y=0; $y<16; $y++) {?>
<tr>
<?for($x=0; $x<16; $x++) {?>
<td>
<?=$Chars[$x][$y][0]?>:
<b><tt><?=$Chars[$x][$y][1]?></tt></b>
</td>
<?}?>
</tr>
<?}?>
</table>
ord
Возвращает ascii код символа.
Синтаксис:
int ord(string str)
Эта функция возвращает ASCII код первого символа строки
Функции отрезания пробелов
trim
Удаляет из заданной строки начальные и конечные пробельные символы.
Синтаксис:
string trim(string str)
Возвращает копию
Например, вызов trim(" testn ") вернет строку "test".
Поиск в тексте
strchr
Поиск первого вхождения символа в строку.
Синтаксис:
string strchr(string haystack, string needle)
Данная функция работает идентично функции strstr().
strstr
Поиск первого вхождения подстроки в строку.
Синтаксис:
string strstr(string haystack, string needle)
Функция strstr() возвращает участок строки, заданной в параметре
В случае неудачи возвращает
Данная функция чувствительна к регистру.
В случае, если
$email = "mailname@mail.ru";
$domain = strstr($email, "@");
// или
$domain = strstr($email, ord("@"))
echo $domain;
// выведет @mail.ru
stristr
Нахождение первого вхождения подстроки, не учитывая регистр.
Синтаксис:
string stristr(string haystack, string needle)
Функция stristr() возвращает участок строки, заданной в параметре
В случае неудачи возвращает
Данная функция нечувствительна к регистру.
В случае, если
strrchr
Поиск последнего вхождения подстроки.
Синтаксис:
string strrchr(string haystack, string needle)
Функция strrchr() возвращает участок строки, заданной в параметре
В случае неудачи возвращает
Данная функция чувствительна к регистру.
В случае, если
// получим последний каталог в $PATH
$dir = substr(strrchr($PATH, ":"), 1);
// а здесь получим все после последнего перевода строки
$text = "text 1nText2nText3";
echo substr(strrchr($text, 10), 1);
strpos
Находит позицию первого вхождения подстроки в заданной строке.
Синтаксис:
int strpos(string where, string what [, int fromwhere])
Функция strpos() пытается найти в строке
Если параметр
if(strpos($text, "a")===false) echo "Не найдено!";
// Проверка: три знака равенства
strrpos
Находит в заданной строке последнюю позицию, в которой находится заданный фрагмент.
Синтаксис:
int strrpos(string where, string what)
Данная функция ищет в строке
Если искомый символ стоит первый в строке или его вообще нет, функция возвратит 0.
В случае, если искомый символ не найден, возвращает
substr_count
Находит количество вхождений фрагмента в строку.
Синтаксис:
int substr_count(string where, string what)
Функция substr_count() возвращает число фрагментов
echo substr_count("www.spravkaweb.ru", ".");
// Выведет 3
strspn
Определяет присутствие начальных символов в строке.
Синтаксис:
int strspn(string str1, string str2)
Функция strspn() возвращает длину начального фрагмента строки
echo strspn("www.spravkaweb.ru", "abc");
// Выведет 3
strcspn
Определяет отсутствие начальных символов в строке.
Синтаксис:
int strcspn(string str1, string str2)
Функция strspn() возвращает длину начального фрагмента строки
Функции сравнения
strcmp
Сравнивает строки.
Синтаксис:
int strcmp(string str1, string str2)
Эта функция сравнивает две строки посимвольно (точнее, бобайтово) и возвращает:
Так как сравнение идет побайтово, то регистр символов влияет на результаты сравнений.
strncmp
Сравнивает начала строк.
Синтаксис:
int strncmp(string str1, string str2, int len)
Эта функция отличается от strcmp() тем, что сравнивает не все слово целиком, а первые
Эта функция сравнивает две строки посимвольно (точнее, бобайтово) и возвращает:
Так как сравнение идет побайтово, то регистр символов влияет на результаты сравнений.
strcasecmp
Сравнивает строки без учета регистра.
Синтаксис:
int strcasecmp(string str1, string str2)
То же самое, что и strcmp(), только при работе не учитывается регистр букв.
$str1 = "Привет!";
$str2 = "привет!";
if(!strcesecmp($str1, $str2))
echo "$str1 == $str2 при сравнении строк без учета регистра";
strncasecmp
Сравнивает начала строк без учета регистра.
Синтаксис:
int strncasecmp(string str1, string str2, int len)
Функция strncasecmp() является комбинацией функций strcasecmp() и strncmp().
strnatcmp
Производит "естественное" сравнение строк.
Синтаксис:
int strnatcmp(string str1, string str2)
Данная функция имитирует сравнение строк, которое использовал бы человек.
$arr1 = $arr2 = array("img12.png", "img10.png", "img2.png", "img1.png");
echo "Обычная сортировкаn";
usort($arr1, "strcmp");
print_r($arr1);
echo "nЕстенственная сортировкаn";
usort($arr2, "strnatcmp");
print_r($arr2);
Данный скприпт выведет следующее:
Обычная сортировкаArray( [0] => img1.png [1] => img10.png [2] => img12.png [3] => img2.png)Естественная сортировкаArray( [0] => img1.png [1] => img2.png [2] => img10.png [3] => img12.png)
strnatcasecmp
Производит "естественное" сравнение строк без учета регистра.
Синтаксис:
int strnatcasecmp(string str1, string str2)
То же, что и strnatcmp(), только игнорирует регистр.
similar_text
Производит определение схожести двух строк.
Синтаксис:
int similar_text(string firsrt, string second [, double percent])
Функция similar_text() вычисляет схожесть двух строк по алгоритму, описанному Оливером (Oliver [1993]). Но вместо стека (как в псевдокоде Оливера) она использует рекурсивные вызовы.
Сложность алгоритма делает функцию медленной, и ее скорость пропорциональна (N^3), где N - длина наибольшей строки.
Функция возвращает число символов, совпавших в обеих строках. При передаче по ссылке третьего необязательного параметра в нем сохраняется процент совпадения строк.
levenshtein
Определение различия Левенштейна двух строк.
Синтаксис:
int levenshtein(string str1, string str2)int levenshtein(string str1, string str2, int cost_ins, int cost_rep, int cost_del)int levenshtein(string str1, string str2, function cost)
"Различие Левенштейна" - это минимальное чило символов, которое требовалось бы заменить, вставить или удалить для того, чтобы превратить строку
Первая форма функции возвращает число необходимых операций над символами строк для трансформации
Вторая форма имеет три дополнительных параметра: стоимость операции вставки, замены и удаления, что делает ее более адаптированной для вычисления, но при этом менее быстродействующей. Возвращается интегральный показатель сложности трансформации.
Третий вариант позволяет указать функцию, используемую для расчета сложности трансформации.
Функция
Вызываемая функция должна будет возвратить стоимость этой операции.
Если длина одной из строк более 255 символов, функция levenshtein() возвращает -1, но такая длина более чем достаточна.
Форматирование и вывод строк
Выводит строку, значение переменной или выражение.
Синтаксис:
print(string arg)
Функция print() выводит аргумент
echo
Производит вывод одного или нескольких значений.
Синтаксис:
echo(string arg1, string [argn]...)
Функция echo() выводит значения перечисленных параметров.
echo() - фактически языковая конструкция, поэтому для нее не обязательны скобки, даже если используется несколько аргументов.
echo "Перенос на следующую строку,
имеющийся в коде, сохраняется
и используется при выводе".
"чтобы избежать этого используйте".
"оператор конкатенации";
printf
Вывод отформатированной строки.
Синтаксис:
int printf(string format [, mixed args, ...]);
Делает то же самое, что и sprintf(), только результирующая строка не возвращается, а направляется в браузер пользователя.
sprintf
Производит форматирование строки с подстановкой переменных.
Синтаксис:
sprintf($format [,args, ...])
Эта функция возвращает строку, составленную на основе строки форматирования, содержащей некоторые специальные символы, которые будут впоследствии заменены на значения соответствующих переменных из списка аргументов.
Строка форматирования
echo sprintf("The percentage was %d%%",$percentage);
Каждый спецификатор формата включает максимум пять элементов (в порядке их следования после символа %):
Вот как можно указать точность представления чисел с плавающей точкой:
$money1 = 68.75;
$money2 = 54.35;
$money = $money1 + $money2;
// echo $money выведет "123.1"...
$formatted = sprintf ("%01.2f", $money);
// echo $formatted выведет "123.10"!
Вот пример вывода целого числа, предваренного нужным количеством нулей:
$isodate=sprintf("%04d-%02d-%02d",$year,$month,$day);
sscanf
Производит интерпретацию строки согласно формату и занесение значений в переменные.
Синтаксис:
mixed sscanf(string str, string format [, string var1 ...])
Функция sscanf() является противоположностью функции printf(). Она интерпретирует строку
// получение серийного номера
$serial = sscanf("SN/235-0001", "SN/%3d-%4d");
echo $serial[0]*10000+$serial[1]; // выводит: 2350001
// и даты изготовления
$date = "January 01 2000";
list($month, $day, $year) = sscanf($date, "%s %d %d");
echo "Дата: $year-".substr($month,0,3)."-$dayn";
// выводит: 2000-Jan-01
При указании дополнительных необязательных параметров (их следует передавать по ссылке) функция возвращает их число. Те переменные, которые не получают значений, в возвращаемом значении не учитываются.
// генерируем XML запись из строки
$auth = "765tLewis Carroll";
$n = sscan($auth,"%dt%s %s", &$id, &$first, &$last);
echo "<author id="$id">
<firstname>$first</firrstname>
<surname>$last</surname>
</author>n";
Составление/разбиение строк
substr
Возвращает участок строки с определенной длиной.
Синтаксис:
string substr(string str, int start [,int length])
Возвращает участок строки
Однако эта функция может делать и еще довольно полезные вещи. К примеру, если мы передадим в
Параметр
$str = substr("abcdef", 1); // возвратит "bcdef"
$str = substr("abcdef", 1, 3); // возвратит "bcd"
$str = substr("abcdef", -1); // возвратит "f"
$str = substr("abcdef", -2); // возвратит "ef"
$str = substr("abcdef", -3, 1); // возвратит "d"
$str = substr("abcdef", 1, -1); // возвратит "bcde"
str_repeat
Повторяет строку определенное количество раз.
Синтаксис:
string str_repeat(string str, int number)
Функция "повторяет" строку
echo str_repeat("test!",3); // выводит test!test!test!
str_pad
Дополняет строку другой строкой до определенной длины.
Синтаксис:
string str_pad(string input, int pad_length [, string pad_string [, int pad_type]])
Аргумент
При помощи необязательного аргумента
При помощи необязательного аргумента
Этот аргумент может принимать следующие значения:
$str = "Aaaaa";
echo str_pad($str, 10);
// возвратит "Aaaaa"
echo str_pad($str, 10, "-=", STR_PAD_LEFT);
// возвратит "-=-=-Aaaaa"
echo str_pad($str, 10, "_", STR_PAD_BOTH)
// возвратит "_Aaaa_"
chunk_split
Возвращает фрагмент строки.
Синтаксис:
string chunk_split(string str [, int chunklen [, string end]])
Функция chunk_split() возвращает строку, в которой между каждым блоком строки
Данная функция может быть полезна при конвертировании в формат "base64" для соответствия правилам RFC 2045.
// отформатируем $data, используя семантику RFC 2045
$str = chunk_split(base64_encode($data));
Эта функция работает значительно быстрее, чем ereg_replace().
strtok
Возвращает строку по частям.
Синтаксис:
string strtok(string arg1, string arg2)
Функция возвращает часть строки
$str="This is an example№string№ Aaa";
$tok = strtok($str, " ");
while($tok) {
echo "$tok";
$tok = strtok(" №");
};
// выведет: "This" "is" "an" "example" "string"
Надо заметить, что в качестве разделителей указывается последовательность символов, каждый из которых в отдельности может являться разделителем, но когда в строке последовательно встречаются два или более разделителей, функция возвращает пустую строку (что может прекратить цикл обработки, как в примере).
explode
Производит разделение строки в массив.
Синтаксис:
array explode(string seperator, string str [, int limit])
Функция explode() возвращает массив строк, каждая из которых соответствует фрагменту исходной строки
Необязательный параметр
$str = "Path1 Path2 Path3 Path4";
$str_exp = explode(" ", $str);
// теперь $str_exp = array([0] => Path1, [1] => Path2,
// [2] => Path3, [3] => '', [4] => Path4)
implode
Производит объединение массива в строку.
Синтаксис:
string implode(string glue, array pieces)
Функция implode() возвращает строку, которая содержит последовательно все элементы массива, заданного в параметре
$str = implode(":", $arr);
join
Производит объединение массива в строку.
Синтаксис:
string join(string glue, array pieces)
То же, что и implode().
Работа с блоками текста
str_replace
Заменяет в исходной строке одни подстроки на другие.
Синтаксис:
string str_replace(string from, string to, string str)
Эта функция заменяет в строке
Также эта функция может работать с двоичными строками.
substr_replace
Заменяет в исходной строке одни подстроки на другие.
Синтаксис:
string substr_replace(string str, string replacement, int start [, int lemgth])
Эта функция возвращает строку
Если значение
Если значение
wordwrap
Разбивает исходный текст на строки с определенными завершающими символами.
Синтаксис:
string wordwrap(string str [, int width [, string break [, int cut]]])
Эта функция разбивает блок текста
strtr
Комплексная замена в строке.
Синтаксис:
string strtr(string str, string from, string to)string strtr(string str, array from)
В первом случае функция strtr() возвращает строку
Во втором случае функция strtr() возвращает строку, в которой фрагменты строки
$Subs = array(
"<name>" => "Larry",
"<time>" => date("d.m.Y")
);
$st="Привет, <name>! Сейчас <time";
echo strtr($st,$Subs);
А вот как можно "отменить" действие функции HtmlSpecialChars():
$Trans=array_flip(get_html_translation_table());
$st=strtr($st, $Trans);
В результате мы из строки, в которой все спецсимволы заменены на их HTML-эквиваленты, получим исходную строку.
stripslashes
Удаление обратных слешей.
Синтаксис:
string stripslashes(string str);
Заменяет в строке
stripcslashes
Преобразование специальных символов в их двоичное представление.
Синтаксис:
string stripcslashes(string str);
Возвращает строку, в которой те специальные символы, которые закомментированы (для визуального отображения) обратным слешем, преобразуются в их естественное двоичное представление. Распознаются C-подобные записи, например: n, r ..., восьмеричные и шестнадцатеричные последовательности.
addslashes
Добавление слешей перед специальными символами строки.
Синтаксис:
string addslashes(string str);
Вставляет слеши только перед следующими символами:", " и . Функцию очень удобно использовать при вызове eval().
addcslashes
Форматирование строки слешами в С-представление.
Синтаксис:
string addcslashes(string str, string charlist);
Функция addcslashes() возвращает строку
quotemeta
Цитирование метасимволов.
Синтаксис:
string quotemeta(string str);
Возвращает строку, в которую добавлены обратные слеши "" перед каждым из следующих символов:. \ + * ? [ ^ ] ( $ )
Может использоваться для подготовки шаблонов в регулярных выражениях.
strrev
Производит реверс строки.
Синтаксис:
string strrev(string str)
функция strrev() возвращает строку
Функции для преобразования символов
nl2br
Заменяет символы перевода строки.
Синтаксис:
string nl2br(string string)
Заменяет в строке все символы новой строки \n на <br>\n и возвращает результат. Исходная строка не изменяется. Обратите внимание на то, что символы \r, которые присутствуют в конце строки текстовых файлов Windows, этой функцией никак не учитываются, а потому остаются на старом месте.
strip_tags
Удаляет из строки теги.
Синтаксис:
string strip_tags(string str [, string allowable_tags])
Эта функция удаляет из строки все HTML- и PHP-теги и возвращает результат.
Незавершенные или фиктивные теги вызывают ошибку.
В параметре
$st="
<b>Жирный текст</b>
<tt>Моноширный текст</tt>
<a href=http://spravkaweb.ru>Ссылка</a>";
echo "Исходный текст: $st";
echo "<hr>После удаления тегов: ".striptags($st,"<a><b>").
"<hr>";
Запустив этот пример, мы сможем заметить, что теги <a> и <b> не были удалены (ровно как и их парные закрывающие), в то время как <tt> исчез.
get_meta_tags
Функция ищет и обрабатывает все теги <META>.
Синтаксис:
array get_meta_tags(string filename, int use_include_path)
Функция открывает файл и ищет в нем все теги <META> до тех пор, пока не встретится закрывающий тег </head>.
Если очередной тег <META> имеет вид:
<meta name="название" content="содержимое">
то пара
Спецсимволы в значении атрибута
Функция удобно использовать для быстрого получения всех метатегов из указанного файла.
Если необязательный параметр
get_html_translation_table
Функция возвращает таблицу трансляции, которая используется функциями htmlspecialchars() и htmlentities().
Синтаксис:
string get_html_translation_table(int table [, int quote_style])
В этой функции аргумент
$trans = get_html_translation_table(HTML_ENTITIES);
$str = "<A & B>";
$encoded = strtr($str, $strans);
// $encoded = "&lt; A & B >"
Иногда удобно использовать функцию array_flip() для изменения направления транслитерации.
$trans = array_flip($trans);
$original = strtr($encoded, $trans);
htmlspecialchars
Производит преобразование спецсимволов в HTML-представление.
Синтаксис:
string HtmlSpecialChars(string str [, int quote_style]);
Основное назначение этой функции - гарантировать, что в выводимой строке ни один участок не будет воспринят как тэг.
Заменяет в строке некоторые символы (такие как амперсанд, кавычки и знаки "больше" и "меньше") на их HTML-эквиваленты,так, чтобы они выглядели на странице "самими собой". Самое типичное применение этой функции - формирование параметра
При помощи необязательного атрибута
$str = htmlspecialchars("<a href=index.php>Главная</a>", ENT_QUOTES);
htmlentities
Производит конвертацию символов, имеющих HTML-представление.
Синтаксис:
string htmlentities(string str [, int quote_style]);
Эта функция похожа на htmlspecialchars(), но только в ней производиться не выборочная трансляция, а полная - для всех символов, которые могут иметь эквивалентные HTML-представления.
При помощи необязательного атрибута
hebrev
Конвертация логического текста Hebrew в отображаемый.
Синтаксис:
string hebrev(string hebrew_text [, int max_chars_per_line]);
Необязательный аргумент
hebrevc
Аналог функции hebrev() с расстановкой переносов.
Синтаксис:
string hebrevc(string hebrew_text [, int max_chars_per_line]);
Функция hebrevc() сходна с hebrev() с тем отличием, что она преобразует символы перевода строк "n" в "<br>n".
Необязательный аргумент
quoted_printable_decode
Преобразование цитированной строки в 8-битную.
Синтаксис:
string quoted_printable_decode(string str);
Функции изменения регистра
strtolower
Производит преобразование символов строки в нижний регистр.
Синтаксис:
string strtolower(string str);
Преобразует строку в нижний регистр. Возвращает результат перевода.
Надо заметить, что при неправильной настройке локали функция будет выдавать, мягко говоря, странные результаты при работе с буквами кириллицы.
$str = "HeLLo World";
$str = strtolower($str);
echo $str;
// выведет hello world
strtoupper
Производит преобразование заданной строки в верхний регистр.
Синтаксис:
string strtoupper(string str);
Переводит строку в верхний регистр. Возвращает результат преобразования. Эта функция хорошо работает с английскими буквами, но с русскими может чудить.
$str = "Hello World";
$str = strtoupper($str);
echo $str;
// выведет HELLO WORLD
ucfirst
Производит преобразование первого символа строки в верхний регистр.
Синтаксис:
string ucfirst(string str);
Возвращает строку, у которой первый символ заглавный.
Символы кириллицы могут быть неправильно конвертированы.
$str = "hello world";
$str = ucfirst($str);
echo $str;
// выведет Hello world
ucwords
Производит преобразование первого символа каждого слова строки в верхний регистр.
Синтаксис:
string ucwords(string str);
Возвращает строку, у которой первый символ каждого слова в строке заглавный.
Под словом здесь понимается участок строки, которому предшествует пробельный символ: пробел, переход на новую строку, прогонка страницы, возврат каретки, горизонтальная и вертикальная табуляция.
Символы кириллицы могут быть неправильно конвертированы.
$str = "hello world";
$str = ucfirst($str);
echo $str;
// выведет Hello World
Установка локали (локальных настроек)
setlocale
Установка региональных настроек.
Синтаксис:
string SetLocale(string category, string locale);
Функция setlocale устанавливает текущую локаль, с которой будут работать функции преобразования регистра символов, вывода даты-времени и т.д. Вообще говоря, для каждой категории функций локаль определяется отдельно и выглядит по-разному. То, какую именно категорию функций затронет вызов setlocale(), задается в параметре
Теперь поговорим о параметре
setlocale("LC_CTYPE","ru_SU.KOI*-R");
// Здесь вызов устанавливает таблицу замены
// регистра букв в соответствии с кодировкой KOI8-R.
Преобразование кодировок
convert_cyr_string
Преобразует строку из одной кодировки кириллицы в другую.
Синтаксис:
string convert_cyr_string(string str, string from, string to);
Функция переводит строку
Функция работает достаточно быстро, так что ее вполне можно применять для перекодировки писем в нужную форму перед их отправкой по электронной почте.
bin2hex
Производит преобразование символьных данных в шестнадцатеричный вид.
Синтаксис:
string bin2hex(string str)
Функция bin2hex() возвращает строковое шестнадцатеричное представление символьно-байтовых данных, содержащихся в строке
Конвертация производиться побайтово, старший полубайт указывается первым.
Функции URL
parse_url
Обрабатывает URL и возвращает его компоненты.
Синтаксис:
array parse_url(string url);
Эта функция возвращает ассоциативный массив, включающий множество различных существующих компонентов URL. Они включают "scheme", "host", "port", "user", "pass", "path", "query" и "fragment".
parse_str
Заносит строки URL в переменные.
Синтаксис:
void parse_str(string str [, array arr]);
Функция parse_str() интерпретирует строку
Если задан второй необязательный параметр, то значения, найденные при помощи функции parse_str(), сохраняться не в глобальных переменных, а в элементах указанного массива.
$str = "name[]=Vasia&name[]=Pupkin&id=12645&mail=vasia@mail.ru&url=www.vasia.ru";
parse_str($str);
parse_str($str, $arr);
echo $id; // выведет 1264
echo $name[0]; // выведет Vasia
echo $name[1]; // выведет Pupkin
print_r($arr);
выведет
Array( [name] => Array ( [0] => Vasia [1] => Pupkin ) [id] => 12645 [mail] => vasia@mail.ru [url] => www.vasia.ru)
urlencode
Кодирование строки в URL
Синтаксис:
string urlencode (string str)
Возвращает строку, в которой все не алфавитно-цифровые символы (за исключением дефиса "-" и знака подчеркивания "_" и точки ".") заменены последовательностями: знак процента (%), за которым следуют две шестнадцатеричные цифры (обозначающие код символа), а символ пробела заменен на знак "+". Именно таким образом кодируются все данные, посылаемые HTML-формами. Медиа-тип этого кодирования обозначается как application/x-www-form-urlencoded; он отличается от стандарта кодирования RFC 1738 (rawurlencode()) тем, что по историческим причинам пробелы заменяются на знак плюс. Эта функция удобна при кодировании строки для использования в строке запроса, являющейся частью URL, и при передаче переменных на следующую страницу:
<?php
echo '<a href="mycgi?foo=', urlencode($userinput), '">';
?>
<?php
$query_string = 'foo=' . urlencode($foo) . '&bar=' . urlencode($bar);
echo '<a href="mycgi?' . htmlentities($query_string) . '">';
?>
urldecode
Декодирование строки из URL
Синтаксис:
string urldecode (string str)
Декодирует в строке последовательности %## (так в URL кодируются спецсимволы).
<?php
$a = explode('&', $QUERY_STRING);
$i = 0;
while ($i < count($a)) {
$b = split('=', $a[$i]);
echo 'Value for parameter ', htmlspecialchars(urldecode($b[0])),
' is ', htmlspecialchars(urldecode($b[1])), "<br />\n";
$i++;
}
?>
rawurlencode
Кодирование URL.
Синтаксис:
string RawUrlEncode(string str);
Функция RawUrlEncode() возвращает строку, в которой все не алфавитно-цифровые символы (за исключением дефиса "-", знака подчеркивания "_" и точки ".") заменены последовательностями: знак процента (%), за которым следуют две шестнадцатеричные цифры, которые обозначают код символа. Это кодирование нужно для того, чтобы буквенные символы не обрабатывались в качестве разделителей строки URL и не искажались при передаче в сетях.
echo "<A href=ftp://user:".rawurlencode($mypasswd).
"@ftp.my.com/x.txt>"; // передача пароля в гиперссылке
rawurldecode
Производит декодирование URL.
Синтаксис:
string rawurldecode(string str);
Эта функция возвращает строку, в которой последовательности с знаком процента (%) и следующими за ним двумя шестнадцатеричных числа преобразует в символы, соответствующими этому коду. Аналогична urldecode(), но не воспринимает + как пробел.
$str="foo%20bar%40baz";
echo rawurldecode($str);
// выведет foo bar@baz
base64_encode
Кодирует данные в кодировке MIME base64.
Синтаксис:
string base64_encode(string data);
base64_encode() возвращает
base64_decode
Декодирует данные, закодированные в кодировке MIME base64.
Синтаксис:
string base64_decode(string encoded_data);
base64_decode() декодирует
Работа с бинарными данными
pack
Пакетирование данных в двоичную строку.
Синтаксис:
string pack(string format [,mixed $args, ...]);
Функция pack() упаковывает заданные аргументы в бинарную строку, которая затем и возвращается. Формат параметров, а также их количество, задается при помощи строки
Вот полный список спецификаторов формата:
// Целое, целое, все остальное - сиволы
$bindata = pack("nvc*", 0x1234, 0x5678, 65, 66);
После выполнения приведенного кода в строке
unpack
Распаковывает данные из двоичной строки.
Синтаксис:
array unpack(string format, string data);
Распаковывает данные из двоичной строки в массив согласно формату. Возвращает массив, содержащий распакованные элементы.
$array = unpack("c2chars/nint", $binarydata);
Возникающий в результате массив будет содержать "chars1", "chars2" и "int".
Строковые суммы и хеш-функции
strlen
Возвращает длину строки.
Синтаксис:
int strlen(string str)
Возвращает просто длину строки, т.е., сколько символов содержится в
Строка может содержать любые символы, в том числе и с нулевым кодом. Функция strlen() будет правильно работать и с такими строками.
count_chars
Возвращает информацию о символах строки.
Синтаксис:
mixed count_chars(string str [, int mode])
Функция count_chars() подсчитывает частоту встречаемости каждого байта (0-255) в строке
md5
Получение строки-хеша MD5.
Синтаксис:
string md5(string str);
Возвращает хеш-код строки
Хеш-код - это просто строка, практически уникальная для каждой из строк
В то же время, если длина строки
crc32
Получение полиминала строки crc32.
Синтаксис:
int crc32(string str);
Функция crc32() вычисляет 32-битную контрольную сумму строки
Обычно эту функцию используют для проверки целостности переданных данных.
Эта функция работает гораздо быстрее md5(), но в то же время выдает гораздо менее надежные "хеш-коды" для строки. Так что, теперь, чтобы получить методом случайного подбора для двух разных строк одинаковые "хеш-коды", вам потребуется не триллион лет работы самого мощного компьютера, а всего лишь год-другой.
crypt
Производит симметричное шифрование.
Синтаксис:
string crypt(string str [,string salt]);
В аргументе
Хеш-код для одной и той же строки, но с различными значениями
В системах, которые поддерживают несколько алгоритмов шифрования, следующие константы устанавливаются равными 1 или 0, в зависимости от того, поддерживается ли данный алгоритм или нет:
Т.к. данная функция использует односторонний алгоритм шифрования, то функции дешифрования не имеется.
metaphone
Производит вычисление метафон-хеша.
Синтаксис:
string metaphone(string str);
Данная функция схожа по действию с soundex(), вычисляет код произношения слова, переданного в строке
Возвращаемое строковое значение может быть переменной длины.
soundex
Вычисления хеша сходности произношения.
Синтаксис:
string soundex(string str);
Функция soundex() используется для проверки правописания, когда приблизительно известно как звучит слово, но не известно, как оно пишется, и имеется словарь (база данных), относительно которого можно осуществить проверку.
Возвращается строка из 4 символов: первая буква слова и 3 цифры.
soundex("Euler") == soundex("Ellery") == "E460";
soundex("Gauss") == soundex("Ghosh") == "G200";
soundex("Hilbert") == soundex("Heilbronn") == "H416";
soundex("Knuth") == soundex("Kant") == "K530";
soundex("Lloyd") == soundex("Ladd") == "L300";
soundex("Lukasiewicz") == soundex("Lissajous") == "L222";
XML
Введение
SimpleXML предоставляет очень простой в восприятии, интуитивно-понятный доступ к XML-документам, позволяющий совершать разнообразные операции с элементами XML-документа и их атрибутами.
Требования
SimpleXML присутствует в PHP начиная с версии 5.
Установка
SimpleXML установлен в PHP по умолчанию. Для того, чтобы отключить это расширение, перекомпилируйте PHP с ключом
Примеры
Практически все примеры используют XML-документ. Вместо того, чтобы каждый раз повторять содержание XML-документа в каждом примере, мы поместим XML-документ в файл, который будет читать при помощи функции simplexml_load_file().
<?php
$xmlstr = <<<XML
<?xml version='1.0' standalone='yes'?>
<movies>
<movie>
<title>PHP: Behind the Parser</title>
<characters>
<character>
<name>Ms. Coder</name>
<actor>Onlivia Actora</actor>
</character>
<character>
<name>Mr. Coder</name>
<actor>El Act&#211;r</actor>
</character>
</characters>
<plot>
So, this language. It's like, a programming language. Or is it a
scripting language? All is revealed in this thrilling horror spoof
of a documentary.
</plot>
<rating type="thumbs">7</rating>
<rating type="stars">5</rating>
</movie>
</movies>
XML;
?>
Простоту работы с SimpleXML можно продемонстрировать извлечением текста из заданного элемента XML-документа.
Пример 2. Получение текста в <plot>
<?php
include 'example.php';
$xml = simplexml_load_string($xmlstr);
echo $xml->movie[0]->plot; // "So this language. It's like..."
?>
Пример 3. Работа с группой элементов в SimpleXML
Можно применять циклы для получения дочерних элементов заданного элемента (если дочерние элементы существуют).
<?php
include 'example.php';
$xml = simplexml_load_string($xmlstr);
/* Для каждого элемента <movie> мы отображаем элемент . */
foreach ($xml->movie as $movie) {
echo $movie->plot, '<br />';
}
?>
Пример 4. Использование атрибутов
Выше было показано как работать с элементами XML-документа и их значениями. SimpleXML также имеет доступ к атрибутам элементов. Атрибуты указанного элемента доступны как ассоциативный массив данного элемента.
<?php
include 'example.php';
$xml = simplexml_load_string($xmlstr);
/* Получение доступа к атрибутам элементов <rating> для первого кино.*/
foreach ($xml->movie[0]->rating as $rating) {
switch((string) $rating['type']) { // Возвращает атрибуты как элементы массива
case 'thumbs':
echo $rating, ' thumbs up';
break;
case 'stars':
echo $rating, ' stars';
break;
}
}
?>
Пример 5. Сравнение элементов и их атрибутов с текстовыми значениями
Для того, чтобы сравнивать элемент или атрибут со строковыми значениями, или передавать содержание элемента или атрибута в функцию, которая использует строковое значение передаваемого параметра, вы должны использовать элементы и атрибуты как строки с признаком (string). В противном случае PHP воспримет передаваемое значение как объект.
<?php
include 'example.php';
$xml = simplexml_load_string($xmlstr);
if ((string) $xml->movie->title == 'PHP: Behind the Parser') {
print 'Мой любимый фильм.';
}
htmlentities((string) $xml->movie->title);
?>
Пример 6. Использование Xpath
В SimpleXML включена поддержка запросов Xpath. Поиск всех элементов :
<?php
include 'example.php';
$xml = simplexml_load_string($xmlstr);
foreach ($xml->xpath('//character') as $character) {
echo $character->name, ' съиграл ', $character->actor, '<br />';
}
?>
'//' служит групповым символом. Чтобы задать абсолютный путь, требуется убрать один слеш.
Пример 7. Задание новых значений
Данные в SimpleXML не могут быть постоянными. Объект учитывает изменения всех его элементов.
<?php
include 'example.php';
$xml = simplexml_load_string($xmlstr);
$xml->movie[0]->characters->character[0]->name = 'Miss Coder';
echo $xml->asXML();
?>
Результатом вышеуказанного примера будет новый XML-документ, идеентичный оригиналу за исключением того, что в новом XML-документе будет вместо Ms. Coder будет Miss Coder.
Пример 8. Взаимодействие с DOM
PHP имеет механизм конвертации XML-документов из формата SimpleXML в DOM и обратно. Следующий пример показывает как конвертировать DOM-элемент в SimpleXML-элемент:
<?php
$dom = new domDocument;
$dom->loadXML('<books><book><title>blah</title></book></books>');
if (!$dom) {
echo 'Ошибка преобразования документа';
exit;
}
$s = simplexml_import_dom($dom);
echo $s->book[0]->title;
?>
Содержание:
SimpleXMLElement->asXML -- Возвращает правильно сформированный XML-документ
SimpleXMLElement->attributes -- Возвращает атрибуты элемента.
SimpleXMLElement->children -- Возвращает дочерние элементы для заданного элемента
SimpleXMLElement->xpath -- Выполняет Xpath-запрос к XML-данным
simplexml_import_dom -- Возвращает объектSimpleXMLElement, созданный из DOM-объекта.
simplexml_load_file -- Интерпретирует XML-файл в объект
simplexml_load_string -- Интерпретирует строку с XML в объект
SimpleXML
Введение
SimpleXML предоставляет очень простой в восприятии, интуитивно-понятный доступ к XML-документам, позволяющий совершать разнообразные операции с элементами XML-документа и их атрибутами.
Требования
SimpleXML присутствует в PHP начиная с версии 5.
Установка
SimpleXML установлен в PHP по умолчанию. Для того, чтобы отключить это расширение, перекомпилируйте PHP с ключом
Примеры
Практически все примеры используют XML-документ. Вместо того, чтобы каждый раз повторять содержание XML-документа в каждом примере, мы поместим XML-документ в файл, который будет читать при помощи функции simplexml_load_file().
<?php
$xmlstr = <<<XML
<?xml version='1.0' standalone='yes'?>
<movies>
<movie>
<title>PHP: Behind the Parser</title>
<characters>
<character>
<name>Ms. Coder</name>
<actor>Onlivia Actora</actor>
</character>
<character>
<name>Mr. Coder</name>
<actor>El Act&#211;r</actor>
</character>
</characters>
<plot>
So, this language. It's like, a programming language. Or is it a
scripting language? All is revealed in this thrilling horror spoof
of a documentary.
</plot>
<rating type="thumbs">7</rating>
<rating type="stars">5</rating>
</movie>
</movies>
XML;
?>
Простоту работы с SimpleXML можно продемонстрировать извлечением текста из заданного элемента XML-документа.
Пример 2. Получение текста в <plot>
<?php
include 'example.php';
$xml = simplexml_load_string($xmlstr);
echo $xml->movie[0]->plot; // "So this language. It's like..."
?>
Пример 3. Работа с группой элементов в SimpleXML
Можно применять циклы для получения дочерних элементов заданного элемента (если дочерние элементы существуют).
<?php
include 'example.php';
$xml = simplexml_load_string($xmlstr);
/* Для каждого элемента <movie> мы отображаем элемент . */
foreach ($xml->movie as $movie) {
echo $movie->plot, '<br />';
}
?>
Пример 4. Использование атрибутов
Выше было показано как работать с элементами XML-документа и их значениями. SimpleXML также имеет доступ к атрибутам элементов. Атрибуты указанного элемента доступны как ассоциативный массив данного элемента.
<?php
include 'example.php';
$xml = simplexml_load_string($xmlstr);
/* Получение доступа к атрибутам элементов <rating> для первого кино.*/
foreach ($xml->movie[0]->rating as $rating) {
switch((string) $rating['type']) { // Возвращает атрибуты как элементы массива
case 'thumbs':
echo $rating, ' thumbs up';
break;
case 'stars':
echo $rating, ' stars';
break;
}
}
?>
Пример 5. Сравнение элементов и их атрибутов с текстовыми значениями
Для того, чтобы сравнивать элемент или атрибут со строковыми значениями, или передавать содержание элемента или атрибута в функцию, которая использует строковое значение передаваемого параметра, вы должны использовать элементы и атрибуты как строки с признаком (string). В противном случае PHP воспримет передаваемое значение как объект.
<?php
include 'example.php';
$xml = simplexml_load_string($xmlstr);
if ((string) $xml->movie->title == 'PHP: Behind the Parser') {
print 'Мой любимый фильм.';
}
htmlentities((string) $xml->movie->title);
?>
Пример 6. Использование Xpath
В SimpleXML включена поддержка запросов Xpath. Поиск всех элементов :
<?php
include 'example.php';
$xml = simplexml_load_string($xmlstr);
foreach ($xml->xpath('//character') as $character) {
echo $character->name, ' съиграл ', $character->actor, '<br />';
}
?>
'//' служит групповым символом. Чтобы задать абсолютный путь, требуется убрать один слеш.
Пример 7. Задание новых значений
Данные в SimpleXML не могут быть постоянными. Объект учитывает изменения всех его элементов.
<?php
include 'example.php';
$xml = simplexml_load_string($xmlstr);
$xml->movie[0]->characters->character[0]->name = 'Miss Coder';
echo $xml->asXML();
?>
Результатом вышеуказанного примера будет новый XML-документ, идеентичный оригиналу за исключением того, что в новом XML-документе будет вместо Ms. Coder будет Miss Coder.
Пример 8. Взаимодействие с DOM
PHP имеет механизм конвертации XML-документов из формата SimpleXML в DOM и обратно. Следующий пример показывает как конвертировать DOM-элемент в SimpleXML-элемент:
<?php
$dom = new domDocument;
$dom->loadXML('<books><book><title>blah</title></book></books>');
if (!$dom) {
echo 'Ошибка преобразования документа';
exit;
}
$s = simplexml_import_dom($dom);
echo $s->book[0]->title;
?>
Содержание:
SimpleXMLElement->asXML -- Возвращает правильно сформированный XML-документ
SimpleXMLElement->attributes -- Возвращает атрибуты элемента.
SimpleXMLElement->children -- Возвращает дочерние элементы для заданного элемента
SimpleXMLElement->xpath -- Выполняет Xpath-запрос к XML-данным
simplexml_import_dom -- Возвращает объектSimpleXMLElement, созданный из DOM-объекта.
simplexml_load_file -- Интерпретирует XML-файл в объект
simplexml_load_string -- Интерпретирует строку с XML в объект
asXML
SimpleXMLElement-asXML
SimpleXMLElement-asXML -- Возвращает правильно сформированный XML-документ
Описание
mixed SimpleXMLElement->asXML ( [string filename] )
Метод asXML формирует данные в XML версии 1.0.
Список параметров
Возвращаемые значения
Если имя файла задано, то метод запишет XML данные в указанный файл. В противном случае метод возвратит XML-данные в виде строки.
Замечания
Если в исходном документе в заголовках была указана кодировка XML-документа при помощи параметра
Примеры
Пример 1. Вывести XML
<?php
$string = <<<XML
<a>
<b>
<c>text</c>
<c>stuff</c>
</b>
<d>
<c>code</c>
</d>
</a>
XML;
$xml = simplexml_load_string($string);
echo $xml->asXML(); // <?xml ... <a><b><c>text</c><c>stuff</c> ...
?>
Метод asXML также может работать с Xpath:
Пример 2. Использование метода asXML() в работе с Xpath
<?php
// Продолжение примера, указанного выше.
/* Поиск <a><b><c> */
$result = $xml->xpath('/a/b/c');
while(list( , $node) = each($result)) {
echo $node->asXML(); // <c>text</c> и <c>stuff</c>
}
?>
attributes
SimpleXMLElement-attributes
SimpleXMLElement-attributes -- Возвращает атрибуты элемента.
Описание
SimpleXMLElement simplexml_element->attributes ( [string data] )
Эта функция возвращает названия и значения атрибутов выбранного xml-элемента.
Замечание: SimpleXML содержит правило добавления итеративных свойств к большинству методов. Они не могут быть просмотрены с испольванием var_dump() или каких-либо других средств анализа объектов.
Пример 1. Интепретация XML-строки
<?php
$string = <<<XML
<users>
<user name="Evgen" age="27">admin@spravkaweb.ru</user>
</users>
XML;
$xml = simplexml_load_string($string);
foreach($xml->users[0]->attributes() as $a => $b) {
echo $a,'="',$b,"\"\n";
}
?>
Данный пример выведет:
name="Evgen"age="27
children
SimpleXMLElement-children
SimpleXMLElement-children -- Возвращает дочерние элементы для заданного элемента
Описание
SimpleXMLElement simplexml_element->children ( [string nsprefix] )
Данный метод находит дочерние элементы для заданного элемента.
Замечание: SimpleXML содержит правило добавления итеративных свойств к большинству методов. Они не могут быть просмотрены с использованием var_dump() или каких-либо других средств анализа объектов.
Пример 1. Использование метода children()
<?php
$xml = simplexml_load_string(
'<sites>
<site name="spravkaweb.ru">
<site name="links.spravkaweb.ru" />
<site name="forum.spravkaweb.ru" />
<site name="server.spravkaweb.ru" />
</site>
<site name="yandex.ru">
<site name="money.yandex.ru" />
<site name="map.yandex.ru" />
<site name="market.yandex.ru" />
</site>
</sites>');
echo '<ul>';
foreach ($xml->children() as $site) {
echo '<dt>' . $site['name'];
foreach ($site->children() as $subsite) {
echo '<dd>' . $subsite['name'];
}
}
echo '</ul>';
?>
Данный пример выведет:
spravkaweb.ru links.spravkaweb.ru forum.spravkaweb.ru server.spravkaweb.ruyandex.ru money.yandex.ru map.yandex.ru market.yandex.ru
xpath
SimpleXMLElement-xpath
SimpleXMLElement-xpath -- Выполняет Xpath-запрос к XML-данным
Описание
array SimpleXMLElement->xpath ( string path )
Метод xpath ищет дочерние элементы элемента SimpleXML, путь к которому указан в параметре
Пример 1. Xpath
<?php
$string = <<<XML
<a>
<b>
<c>text</c>
<c>stuff</c>
</b>
<d>
<c>code</c>
<b>
<c>plain</c>
</b>
</d>
</a>
XML;
$xml = simplexml_load_string($string);
/* Поиск по <a><b><c> */
$result = $xml->xpath('/a/b/c');
foreach ($result as $node) {
echo '/a/b/c: ' . $node . '<BR>';
}
/* Относительные дорожки также работают ... */
$result = $xml->xpath('b/c');
foreach ($result as $node) {
echo 'b/c: ' . $node . '<BR>';
}
?>
Данный скрипт выведет:
/a/b/c: text/a/b/c: stuffb/c: textb/c: stuff
Два результата в данном случае одинаковы.
simplexml_import_dom
simplexml_import_dom
(PHP 5)
simplexml_import_dom -- Возвращает объект SimpleXMLElement, созданный из DOM-объекта.
Описание
SimpleXMLElement simplexml_import_dom ( DOMNode node [, string class_name] )
Данная функция берет объект DOM и создает на его основе объект SimpleXML. Этот новый объект может быть использован как нормальный объект SimpleXML. Если во время создания объекта произошли ошибки, метод вернет
Пример 1. Import DOM
<?php
$dom = new domDocument;
$dom->loadXML('<sites><site><url>spravkaweb.ru</url></site></sites>');
if (!$dom) {
echo 'Ошибка парсинга документа!';
exit;
}
$s = simplexml_import_dom($dom);
echo $s->site[0]->url; // spravkaweb.ru
?>
simplexml_load_file
simplexml_load_file
(PHP 5)
simplexml_load_file -- Интерпретирует XML-файл в объект
Описание
object simplexml_load_file ( string filename [, string class_name [, int options]] )
Эта функция интерпретирует файл
Вы можете использовать необязательный параметр
Начиная с PHP 5.1.0 и Libxml 2.6.0 вы можете использовать необязательный параметр
Замечание: Libxml 2 преобразовывает URL к правильному виду. Т.е. если вы хотите присвоить переменной а значение b&c в URL-строке, вам не обязательно делать:
Пример 1. Интерпретация XML документа
<?php
// Файл test.xml содержит XML документ с корневым элементом
// и вложенным элементом title /[root]/title.
if (file_exists('test.xml')) {
$xml = simplexml_load_file('test.xml');
var_dump($xml);
} else {
exit('Ошибка открытия test.xml.');
}
?>
Этот пример выведет следующее:
SimpleXMLElement Object( [title] => Тестовый заголовок ...)
В данном примере вы можете обратиться к элементу
Смотрите также:
simplexml_load_string()
simplexml_load_string
simplexml_load_string
(PHP 5)
simplexml_load_string -- Интерпретирует строку с XML в объект
Описание
object simplexml_load_string ( string data [, string class_name [, int options]] )
Эта функция берет "правильный" XML-документ, находящийся в строке
Вы можете использовать необязательный параметр
Начиная с PHP 5.1.0 и Libxml 2.6.0, вы можете также использовать необязательный параметр
Пример 1. Преобразование XML-строки
<?php
$string = <<<XML
<?xml version='1.0'?>
<document>
<title>Forty What?</title>
<from>Joe</from>
<to>Jane</to>
<body>
I know that's the answer -- but what's the question?
</body>
</document>
XML;
$xml = simplexml_load_string($string);
var_dump($xml);
?>
Этот пример выведет:
SimpleXMLElement Object( [title] => Forty What? [from] => Joe [to] => Jane [body] => I know that's the answer -- but what's the question?)
В этом примере вы можете также использовать конструкции
Символические ссылки. Жесткие ссылки.
Немного теории
В системах Unix довольно часто возникает необходимость иметь для одного и того же файла или каталога разные имена. При этом одно из имен логично назвать основным, а все другие - его псевдонимами. В терминологии Unix такие псевдонимы называются символическими ссылками.
Символическая ссылка - это просто бинарный файл специального вида, который содержит ссылку на основной файл. При обращении к такому файлу (например, открытию его на чтение) система "соображает", к какому объекту на самом деле запрашивается доступ, и прозрачно его обеспечивает. Это означает, что мы можем использовать символические ссылки точно так же, как и обычные файлы. Однако иногда нужно бывает работать со ссылкой именно как со ссылкой, а не как с файлом. Для этого и существуют перечисленные ниже функции PHP.
Жесткие ссылки
Создание символической ссылки - не единственный способ задать для одного файла несколько имен. Главный недостаток символических ссылок - существование основного имени файла, на которое все и ссылаются. Попробуйте удалить этот файл - и вся "паутина" ссылок, если таковая имелась, развалиться на куски. Есть и другой недостаток: открытие файла, на который указывает ссылка, происходит несколько медленнее, т.к. системе нужно проанализировать содержимое ссылки и установить связь с "настоящим" файлом. Особенно это чувствуется, если одна ссылка указывает на другую, а та на третью и т.д. уровней на 10.
Жесткие ссылки позволяют вам иметь для одного файла несколько совершенно равноправных имен, причем доступ по ним осуществляется одинаково быстро. При этом, если одно из таких имен будет удалено, то сам файл удалиться только в том случае, если данное имя было последним, и других имен у файла нет.
Зарегистрировать новое имя у файла (то есть создать для него жесткую ссылку) можно с помощью функции link(). Ее синтаксис полностью идеентичен функции symlink(), да и работает она по тем же правилам, за исключением того, что создает не символическую, а жесткую ссылку.
readlink
Возвращает имя основного файла.
Синтаксис:
string readlink(string $linkname)
Возвращает имя основного файла, с которым связан его синоним
symlink
Создает символическую ссылку.
Синтаксис:
bool symlink(string $target, string $link)
Эта функция создает символическую ссылку с именем
lstat
Функция собирает вместе всю информацию, выдаваемую операционной системой для указанной ссылки, и возвращает ее в виде массива.
Синтаксис:
array lstat(string $filename)
Функция полностью аналогична вызову stat(), за исключением того, что если
linkinfo
Функция возвращает значение поля "устройство" из результата, выдаваемого функцией lstat().
Синтаксис:
int linkinfo(string $linkname)
Ее обычно задействуют, если хотят определить, существует ли еще объект, на который указывает символическая ссылка в
Функции даты и времени
checkdate
Проверяет правильность даты/времени.
Синтаксис:
int checkdate(int month, int day, int year);
Функция checkdate() проверяет правильность даты, заданной в ее аргументах.
Возвращает
$month=1;
$day=10;
$year=2002;
if(checkdate($month,$day,$year)) echo "Такой день есть!";
else echo "Такого дня нет!";
Выведет:
Такой день есть!
$month=13;
$day=10;
$year=2002;
if(checkdate($month,$day,$year)) echo "Такой день есть!";
else echo "Такого дня нет!";
Выведет:
Такого дня нет!
date
Формат локального времени/даты.
Синтаксис:
string date(string format [, int timestamp]);
Эта функция возвращает строку, содержащую дату и время, отформатированную согласно строке
В фоматной строке должны использоваться следующие символы:
Все остальные символы в строковом аргументе
Формат "Z" всегда возвращает 0 при использовании с функцией gmdate().
echo date("Сегодня d.m.Y");
//Сегодня 31.01.2002
echo date( "l dS of F Y h:i:s A" );
// Thursday 31st of January 2002 12:51:19 PM
echo "July 1, 2000 is on a " . date("l", mktime(0,0,0,7,1,2000));
// July 1, 2000 is on a Saturday
Функции date() и mktime() возможно использовать вместе для того, чтобы найти даты в будущем или прошлом.
$tomorrow = mktime(0,0,0,date("m") ,date("d")+1,date("Y"));
$lastmonth = mktime(0,0,0,date("m")-1,date("d"), date("Y"));
$nextyear = mktime(0,0,0,date("m"), date("d"), date("Y")+1);
localtime
Получает информацию о дате/времени.
Синтаксис:
array localtime([int timestamp [, bool is_associative]]);
Первый необязательный аргумент этой функции задает метку времени Unix. В случае, если он не указан, то используется текущее время.
Если второй необязательный параметр равен нулю (по умолчанию), то возвращаемый массив будет численно индексирован; в противном случае возвращается ассоциативный массив, где элементы имеют следующие значения:
gettimeofday
Получени даты системным вызовом.
Синтаксис:
array gettimeofday();
Эта функция возвращает ассоциативный массив, который содержит дату, возвращенную системным вызовом. Функция является интерфейсом системной функции gettimeofday(2).Возвращаемый ассоциативный массив содержит следующие элементы:
strftime
Форматирует время согласно локальным установкам.
Синтаксис:
string strftime(string format [, int timestamp]);
Возвращает строку, отформатированную согласно данной форматной строке
Функцией setlocale() можно выставить язык, на котором будут выводиться названия месяцев и дней.
В форматной строке следует использовать следующие спецификаторы преобразований:
setlocale ("LC_TIME", "C");
print(strftime("%A in Finnish is "));
setlocale ("LC_TIME", "fi");
print(strftime("%A, in French "));
setlocale ("LC_TIME", "fr");
print(strftime("%A and in German "));
setlocale ("LC_TIME", "de");
print(strftime("A.n"));
Форматирует локальное время согласно установкам
getdate
Получает информацию о дате/времени.
Синтаксис:
array getdate(int timestamp);
Возвращает ассоциативный массив, содержащий информацию о дате со следующими элементами:
print_r(getdate(time()));
Приведенный пример выведет следующее:
Array( [seconds] => 23 [minutes] => 44 [hours] => 22 [mday] => 15 [wday] => 0 [mon] => 8 [year] => 2004 [yday] => 227 [weekday] => Sunday [month] => August [0] => 1092595463)
gmdate
Получение даты в форматированной строке для времени GMT.
Синтаксис:
string gmdate(string format, int timestamp);
Аналогична функции date() за исключением того, что время возвращается в Гринвичском формате Greenwich Mean Time (GMT). Например, при запуске в Финляндии (GMT +0200), первая строка ниже напечатает "Jan 01 1998 00:00:00", в то время как вторая строка напечатает "Dec 31 1997 22:00:00".
echo date( "M d Y H:i:s",mktime(0,0,0,1,1,1998) );
echo gmdate( "M d Y H:i:s",mktime(0,0,0,1,1,1998) );
gmstrftime
Форматирование локальных времени/даты.
Синтаксис:
string gmstrftime(string format, int timestamp);
Действие этой функции аналогично действию функции strftime() с тем отличием, что возвращается время по Гринвичу (GMT).
Например, при запуске в зоне (GMT -0500) первая строка бедт следующей: "Dec 31 1998 20:00:00", а вторая: " Jan 01 1999 01:00:00".
setlocale("LC_TIME", "en_US");
echo strftime("%b %d %Y %H:%M:%S", mktime(20,0,0,12,31,98))."n";
echo gmstrftime("%b %d %Y %H:%M:%S", mktime(20,0,0,12,31,98))."n";
mktime
Получает временную метку UNIX для даты.
Синтаксис:
int mktime([int hour] [,int minute] [,int second] [,int month] [,int day] [,int year] [, int is_dst]);
Возвращает временную метку Unix согласно данным аргументам. Эта временная метка является целым числом, равным количеству секунд между эпохой Unix (1 Января 1970) и указанным временем.
Все парамеры это функции необязательны, но пропускать их можно только справо налево. Если какие-то параметры не заданы, на их место подставляются значения, соответствующие текущей дате.
Аргумент
Функция возвращает
Правильность даты, переданной в параметрах, не проверяется. В случае некорректной даты ничего особенного не происходит - функция "делает вид", что ее не касается, и формирует соответствующий timestamp.
echo date( "M-d-Y", mktime(0,0,0,12,32,1997) ); // правильная дата
echo date( "M-d-Y", mktime(0,0,0,13,1,1997) ); // неправильная дата
echo date( "M-d-Y", mktime(0,0,0,1,1,1998) ); // неправильная дата
Выводит три одинаковых числа
gmmktime
Аналог функции time() для времени GMT.
Синтаксис:
int gmmktime(int hour, int minute, int second, int month, int day, int year [, int is_dst]);
Идентична mktime() за исключением того, что передаваемые параметры передают время по Гринвичу (GMT).
time
Получение времени в секунадх.
Синтаксис:
int time();
Возвращает текущее время, измеренное в числе секунд с эпохи Unix (1 Января 1970 00:00:00 GMT).
Этот формат данных принят в Unix как стандартный (называется "UNIX timestamp"): в частности, время последнего изменения файлов указывается именно в таком формате. Вообще говоря, почти все функции по работе со временеи имеют дело именно с таким его представлением (которое называется timestamp). То есть представление " количество секунд с 1 января 1970 года" весьма универсально и, что главное, - удобно.
echo time();
microtime
Возвращает текущую временную метку UNIX в микросекундах.
Синтаксис:
string microtime();
Возвращает строку "msec sec" где sec текущее время, измеренное в числе секунд с эпохи Unix (0:00:00 1 Января, 1970 GMT), а msec - это часть в микросекундах. Эти функции доступны только в операционных системах, поддерживающих системный вызов gettimeofday().
Но дело в том, что милисекунды в различных OC выглядят по разному. Например в Unix это действительно число микросекунд, а в Windows - непонятное значение.
echo microtime(); // в Windows выведет что-то типа 0.53033200 1012468870
strtotime
Лексическое преобразование строки времени в Unix timestamp.
Синтаксис:
int strtotime(string time [, int now]);
В аргументе
echo strtotime("now")."n";echo strtotime("10 September 2002")."n";echo strtotime("+2 day")."n";echo strtotime("+3 week")."n";echo strtotime("+1 week 2 days 4 hours 34 seconds")."n";
Логические функции определения типа переменной
is_scalar
Проверяет, является ли переменная простой.
Синтаксис:
bool is_scalar(mixed var)
Возвращает true, если
is_null
Проверяет, является ли переменная пустой.
Синтаксис:
bool is_null(mixed var)
Возвращает
is_numeric
Проверяет, является ли переменная числовой.
Синтаксис:
bool is_numeric(mixed var)
Возвращает
is_bool
Проверяет, является ли переменная логической.
Синтаксис:
bool is_bool(mixed var)
Возвращает
is_int
Определяет, является ли переменная типа integer(целочисленной).
Синтаксис:
bool is_int(mixed var);
Возвращает
is_integer
Определяет, является ли переменная типа integer.
Синтаксис:
bool is_integer(mixed var);
Возвращает
is_long
Определяет, является ли переменная типа integer(целочисленной).
Синтаксис:
bool is_long(mixed var);
Возвращает
is_real
Определяет, является ли переменная типа real (дробной).
Синтаксис:
bool is_real(mixed var);
Возвращает
is_float
Определяет, является ли переменная типа float (дробная).
Синтаксис:
bool is_float(mixed var);
Возвращает
is_double
Определяет, является ли переменная типа double (дробная).
Синтаксис:
bool is_double(mixed var);
Возвращает
is_string
Определяет, является ли переменная строкой.
Синтаксис:
bool is_string(mixed var);
Возвращает
is_array
Определяет, является ли переменная массивом.
Синтаксис:
bool is_array(mixed var);
Возвращает
is_object
Определяет, является ли переменная объектом.
Синтаксис:
bool is_object(mixed var);
Возвращает
is_resource
Определяет, является ли переменная указателем на ресурс.
Синтаксис:
bool is_resource(mixed var);
Возвращает
Ресурсы - это объекты, подобные файлам или результатам запросов к базам данных, выделяемые и освобождаемые внутренними функциями PHP. Когда программе больше не требуется какой-либо ресурс, хорошей практикой программирования является его явное освобождение предназначенными для этого функциями. Но в большинстве случаев интерпретатор PHP самостоятельно, по мере необходимости освобождает ненужные ресурсы (обычно при завершении сценария).
get_resource_type
Определение типа дескриптора ресурса.
Синтаксис:
string get_resource_type(resource $handle);
Эта функция возвращает строку, содержащую описание типа ресурса. Если в аргументе передается неверный указатель на ресурс, то возникает ошибка.
$c = mysql_connect();
echo get_resource_type($c)."n";
// выведет: mysql link
$file = fopen("filename.txt","w");
echo get_resource_type($file)."n";
// выведет: file
$doc = new_xmldoc("1.0");
echo get_resource_type($doc)."n";
// выведет: domxml document
Функции переменных
gettype
Получает тип переменной.
Синтаксис:
string gettype(mixed var);
Возвращает тип переменной PHP
Возможные значения для возвращаемой строки:
intval
Возвращает целочисленное значение переменной.
Синтаксис:
int intval(mixed var, int [base]);
Возвращает целочисленное значение переменной
doubleval
Получает значение переменной в формате double.
Синтаксис:
double doubleval(mixed var);
Возвращает double (с плавающей точкой) значение переменной
empty
Определяет, есть ли у переменной какое либо значение.
Синтаксис:
int empty(mixed var);
Возвращает false, если
Фактически функция проверяет, имеет ли переменное значение, которое может быть приравнено к 0, то есть:
$var=0;
if(empty($var)) {
echo "$var - либо 0, либо не имеет значения";
if(!isset($var)) {
echo "$var не имеет значения";
};
};
Заметьте, что эту функцию бесполезно использовать с аргументом, отличным от переменной, например выражение empty (Addslashes($name)) бессмысленно, т.к. здесь проверяется значение, возвращаемое функцией. Единственное, что может выявить в данном варианте функция empty(), это имеет ли выражение значение, эквивалентное true (не равное нулю), а это может быть проверено и без использования функции.
isset
Определяет, существует ли переменная.
Синтаксис:
int isset(mixed var);
Возвращает true, если
Фактически функция проверяет, имеет ли переменная значение, идентичное null, то есть:
Если переменная была удалена функцией unset(), она больше не будет определяться функцией isset().
$a = "test";
echo isset($a); // true
unset($a);
echo isset($a); // false
settype
Устанавливает тип переменной.
Синтаксис:
int settype(string var, string type);
Устанавливает тип переменной
Возможные значения type :
Возвращает true, при успехе; false в обратном случае.
strval
Получает строковое значение переменной.
Синтаксис:
string strval(mixed var);
Получает строковое значение
unset
Удаляет указанную переменную.
Синтаксис:
int unset(mixed var);
unset() уничтожает указанную переменную и возвращает true.
Пример:
unset( $foo );
unset( $bar["quux"] );
Функции для работы с функциями
get_defined_functions
Возвращает перечень всех доступных функций.
Синтаксис:
array get_defined_functions()
Функция get_defined_functions() возвращает многомерный массив, который содержит имена всех доступных сценарию функций.
print_r(get_defined_functions);
function_exists
Проверяет существование функции.
Синтаксис:
bool function_exists(string fuction_name)
Функция function_exists() возвращает значение true, если функция с именем
if(function_exists("imagecreate")) {
echo "Библиотека работы с графикой доступна!
";
} else {
echo "Библиотека работы с графикой недоступна!
";
};
call_user_func
Производит косвенный выбор функции.
Синтаксис:
mixed call_user_func(string function_name [, mixed parameter [, mixed ...]])
Функция call_user_func() вызывает функцию
<?php
function myFunc($str) {
echo $str;
};
call_user_func("myFunc", "Hello World");
?>
create_function
Динамическое создание функции.
Синтаксис:
string create_function(string args, string code)
Функция create_function() создает анонимную функцию и возвращает имя, созданное для этой функции. Аргументы функции, перечисленные в аргументе
Обычно возвращаемые функцией имена содержат префикс
При помощи этой функции можно создавать функции на основе информации, полученной во время исполнения сценария.
$func = create_function('$a,$b',
'return "$a*$b = ".$a*$b);');
echo "Имя новой функции: $func<br>";
echo $func(2,3);
Данный пример выведет следующее:
Имя новой функции: lambda_16
func_get_arg
Получение аргумента функции.
Синтаксис:
mixed func_get_arg(int arg_num);
Функция func_get_arg() возвращает указанный в
В случае, если эта функция вызывается вне определения функции, то она выдает предупреждение об ошибке. Также предупреждение будет выдаваться при попытке узнать параметр, которого не существует в списке аргументов (функция возвратит false). Для того, чтобы функция работала корректно, необходимо заранее узнать общее количество параметров, которое передается в пользовательскую функцию с помощью функции func_num_args().
<?php
function func() {
$num_args=func_num_args();
echo "Число аргументов у этой функции: $num_args<br>";
for($i=0;$i<$num_args;$i++)
echo "$i агрумент: ".func_get_arg($i)."<br>";
};
func("2",1,"tree");
?>
func_get_args
Получение аргументов функции в массиве.
Синтаксис:
array func_get_args();
Функция func_get_args() возвращает в массиве список аргументов, с которым была вызвана текущая пользовательская функция. Если функция func_get_args() вызывается вне определения пользовательской функции, то выдается предупреждение об ошибке.
<?php
function func() {
$num_args = func_num_args();
echo "Число аргументов у этой функции: $num_args<br>";
$func_list = func_get_args();
for($i=0;$i<$num_args;$i++)
echo "$i агрумент номер $i: ".$func_list[$i]."<br>";
};
func("2",1,"tree");
?>
func_num_args
Возвращает число полученных аргументов в пользовательской функции.
Синтаксис:
int func_num_args();
Функция func_num_args() возвращает число аргументов, которые были переданы в текущую пользовательскую функцию.
Обычно эту функцию используют совместно с функциями func_get_arg() и func_get_args() в пользовательских функциях, которые могут принимать неопределенное количество параметров.
<?php
function func() {
$num_args = func_num_args();
echo "Число аргументов у этой функции: $num_args<br>";
$func_list = func_get_args();
for($i=0;$i<$num_args;$i++)
echo "$i агрумент номер $i: ".$func_list[$i]."<br>";
};
func("2",1,"tree");
?>
Календарные функции
JDToGregorian
Преобразование дневного Юлианcкого счета в Грегорианскую дату.
Синтаксис:
string jdtogregorian(int julianday);
Преобразование дневного Юлианcкого счета в Грегорианскую в формате "месяц/день/год"
GregorianToJD
Преобразовывает Грегорианскую дату на Дневный Юлианский cчет.
Синтаксис:
int gregoriantojd(int month, int day, int year);
Правильный диапазон для Грегорианского календаря 4714 д.э. до 9999 н.э.
Хотя это программное обеспечение может оперировать даты в обратном порядке до 4714 д.э., такое использование может быть бесполезно и не значительно. Грегорианский календарь не был учрежден до Октября 15, 1582 (или Октябрь 5, 1582 в Юлианском календаре). Некоторые страны еще очень долго не принимали его. Например, Великобритания преобразовалась в 1752, СССР в 1918 и Греции в 1923. Наиболее Европейские страны использовали Юлианский Календарь До Грегорианского.
Пример:
<?php
$jd = GregorianToJD(10,11,1970);
echo("$jdn");
$gregorian = JDToGregorian($jd);
echo("$gregoriann");
?>
JDToJulian
Преобразовывает дату Юлианского календаря на дневный Юлианский счет.
Синтаксис:
string jdtojulian(int julianday);
Преобразование дневного Юлианского счета в строку, содержащую дату Юлианского Календаря в формате "месяц/день/год".
JulianToJD
Преобразовывает дату Юлианского Календаря на дневной Юлианский счет.
Синтаксис:
int juliantojd(int month, int day, int year);
Правильный диапазон для Юлианского календаря 4713 д.э. до 9999 н.э.
Хотя это программное обеспечение может оперировать даты в обратном порядке до 4713 д.э. такое использование может быть бесполезно и не значительно. Календарь был создан в 46 д.э., но подробные не стабилизировался до по крайней мере 8 н.э., и возможно позднее в 4-ом столетии. Также, начало года различно от одной культуры к другой - не все соглашаются, что Январь это первый месяц.
JDToJewish
Преобразовывает дневной Юлианский счет в Еврейский календарь.
Синтаксис:
string jdtojewish(int julianday);
JewishToJD
Преобразовывает дату в Еврейском Календаре на дневной Юлианский счет.
Синтаксис:
int jewishtojd(int month, int day, int year);
Еврейский календарь использовался в течение нескольких тысячелетий, но в течение начального периода не было никакой формулы, чтобы определить начало месяца. Новый месяц начинался когда замечено полнолуние.
JDToFrench
Преобразовывает дневной Юлианский счет в Французский Республиканский календарь.
Синтаксис:
string jdtofrench(int month, int day, int year);
Преобразовывает дневной Юлианский счет в Французский Республиканский календарь.
FrenchToJD
Преобразовывает дату и Французского Республиканского календаря в дневной Юлианский счет.
Синтаксис:
int frenchtojd(int month, int day, int year);
Эта программа преобразовывают даты в начиная с 1 до 14 (Грегорианские даты 22 Сентября 1792 до 22 1806 Сентября). Это покрывает тот период когда календарь использовался.
JDMonthName
Возвращает название месяца.
Синтаксис:
string jdmonthname(int julianday, int mode);
Возвращает строку с названием месяца. julianday сообщает функции, в какой календарь нужно преобразовать древний Юлианский счет на, и какой тип месячных имен должен быть возвращен.
Календарные способы
JDDayOfWeek
Возвращает день недели.
Синтаксис:
mixed jddayofweek(int julianday, int mode);
Возвращает день недели. Может возвратить строку(string) или int в зависимости от способа(
Календарные недельные пути
Файлы и сети
Работа с файлами
fopen
Открывает файл и привязывает его к дескриптору.
Синтаксис:
int fopen(string $filename, string $mode, bool $use_include_path=false)
Открывает файл с именем
Параметр
Но это еще не полное описание параметра
tmpfile
Создает новый временный файл с уникальным именем и открывает его на чтение и запись.
Синтаксис:
int tmpfile()
В дальнейшем вся работа должна вестись с возвращенным файловым дескриптором, потому что имя файла недоступно.
Пространство, занимаемое временным файлом, автоматически освобождается при его закрытии и при завершении работы программы.
Открытие файла
fopen
Открывает файл и привязывает его к дескриптору.
Синтаксис:
int fopen(string $filename, string $mode, bool $use_include_path=false)
Открывает файл с именем
Параметр
Но это еще не полное описание параметра
tmpfile
Создает новый временный файл с уникальным именем и открывает его на чтение и запись.
Синтаксис:
int tmpfile()
В дальнейшем вся работа должна вестись с возвращенным файловым дескриптором, потому что имя файла недоступно.
Пространство, занимаемое временным файлом, автоматически освобождается при его закрытии и при завершении работы программы.
Закрытие файла
fclose
Закрывает файл, открытый предварительно функцией fopen().
Синтаксис:
int fclose(int $fp)
Возвращает false, если файл закрыть не удалось (например, что-то с ним случилось или же разорвалась связь с удаленным хостом). В противном случае возвращает значение "истина".
Всегда нужно закрывать FTP- и HTTP-соединения, потому что в противном случае "беспризорный" файл приведет к неоправданному простою канала и излишней загрузке сервера. Кроме того, успешно закрыв соединение, вы будете уверены в том, что все данные были доставлены без ошибок.
Чтение и запись
fread
Читает из открытого файла определенное количество символов.
Синтаксис:
string fread(int $f, int $numbytes)
Читает из файла
fwrite
Запись в файл.
Синтаксис:
int fwrite(int $f, string $str)
Записывает в файл
При работе с текстовыми файлами (то есть когда указан символ t в режиме открытия файла) все n автоматически преобразуются в тот разделитель строк, который принят в вашей операционной системе.
fgets
Читает из файла одну строку, заканчивающуюся символом новой строки n.
Синтаксис:
string fgets(int $f, int $length)
Этот символ также считывается и включается в результат. Если строка в файле занимает больше
fputs
Полный аналог fwrite().
Синтаксис:
int fputs(int $f, string $str)
fgetcsv
Функция для работы с одним из форматов файлов, в котором может сохранять данные Excel.
Синтаксис:
list fgetcsv(int $f, int $length, char $delim=",")
Функция читает строку из файла, заданного дескриптором
Пример:
$f=fopen("file.csv","r") or die("Ошибка");
for($i=0; $data=fgetscsv($f, 1000, ";"); $i++) {
$num = count($data);
if($num==1 && $data[0]==="") continue;
echo "<h3>Строка номер $i ($num полей):</h3>";
for($c=0; $c<$num; $c++)
print "[$c]: $data[$c]<br>";
}
fclose($f);
Положение указателя текущей позиции
feof
Указатель конца файла.
Синтаксис:
int feof(int $f)
Возвращает true, если достигнут конец файла (то есть если указатель файла установлен за концом файла).
Пример:
$f=fopen("myfile.txt","r");
while(!feof($f))
{ $str=fgets($f);
// Обрабатываем очередную строку $str
}
fclose($f);
fseek
Устанавливает указатель файла на определенную позицию.
Синтаксис:
int fseek(int $f, int $offset, int $whence=SEEK_SET)
Устанавливает указатель файла на байт со смещением
Параметр
В случае использования последних двух констант параметр
ftell
Возвращает положение указателя файла.
Синтаксис:
int ftell(int $f)
Функции для определения типов файлов
file_exists
Проверяет существование вызываемого файла.
Синтаксис:
bool file_exists(string filename)
Возвращает true, если файл с именем
Например, следующий код никуда не годится с точки зрения безопасности:
if(!file_exists($fname))
$f=fopen($fname,"w");
else
$f=fopen($fname,"r");
Дело в том, что между вызовом file_exists() и открытием файла в режиме w проходит некоторое время, в течение которого другой процесс может вклиниться и подменить используемый нами файл. Данная проблема выходит на передний план при написании сценария счетчика.
Функция не работает с удаленными файлами, файл должен находиться в доступной для сервера файловой системе.
Результаты функции кэшируются, см. функцию clearstatcache().
filetype
Возвращает тип файла.
Синтаксис:
string filetype(string filename)
Возвращает строку, которая описывает тип файла с именем
После вызова строка будет содержать одно из следующих значений:
is_file
Проверка существования обычного файла.
Синтаксис:
bool is_file(string filename)
Возвращает true, если
is_dir
Проверка существования каталога.
Синтаксис:
bool is_dir(string filename)
Возвращает true, если каталог
is_link
Проверка существования символической ссылки на файл.
Синтаксис:
bool is_link(string filename)
Возвращает true, если
Функция не работает под Windows.
is_readable
Проверка существования файла, доступного для чтения.
Синтаксис:
bool is_readable(string filename)
Возвращает true, если файл может быть открыт для чтения.
Обычно PHP осуществляет доступ к файлу с привелегиями пользователя, запускающего web-сервер (часто "nobody"). Соображения безопасности должны приниматься в расчет.
is_writeable
Проверка существования файла, доступного для записи.
Синтаксис:
bool is_writeable(string filename)
Возвращает true, если в файл можно писать.Обычно PHP осуществляет доступ к файлу с привелегиями пользователя, запускающего web-сервер (часто "nobody"). Соображения безопасности должны приниматься в расчет.
is_executable
Проверка существования запускаемого файла.
Синтаксис:
bool is_executable(string filename)
Возвращает true, если файл
is_uploaded_file
Проверка существования файла, загруженного методом HTTP POST.
Синтаксис:
bool is_uploaded_file(string filename)
Возвращает true, если файл с именем
Часто это полезно, чтобы убедиться, что пользователи из злого умысла не пытались заставить сценарий работать с теми файлами, с которыми им работать не следует.
Определение параметров файла
stat
Функция собирает вместе всю информацию, выдаваемую операционной системой для указанного файла, и возвращает ее в виде массива.
Синтаксис:
array stat(string $filename)
Этот массив всегда содержит следующие элементы с указанными ключами:
Этот массив помещает информацию, которая доступна в системах Unix. Под Windows многие поля могут быть пусты.
Если
fileatime
Возвращает время последнего доступа к файлу.
Синтаксис:
int fileatime(string filename)
Время выражается в количестве секунд, прошедших с 1 января 1970 года (Unix timestamp). Если файл не обнаружен, возвращает false.
Атрибут времени последнего доступа к файлу изменяется каждый раз, когда данные файла читаются. Так как это сильно снижает производительность при интенсивной работе с файлами и каталогами, часто изменение этого атрибута в операционных системах блокируют, и тогда функция бесполезна.
filemtime
Возвращает время последнего изменения файла или false в случае отсутствия файла.
Синтаксис:
int filemtime(string $filename)
filectime
Возвращает время создания файла.
Синтаксис:
int filectime(string $filename)
filesize
Возвращает размер файла в байтах или false, если файла не существует.
Синтаксис:
int filesize(string $filename)
touch
Устанавливает время модификации.
Синтаксис:
int touch(string $filename [, int $timestamp])
Устанавливает время модификации указанного файла
Если файл с указанным именем не существует, он создается пустым.
Функции для работы с именами файлов
basename
Выделяет имя файла из пути.
Синтаксис:
string basename(string $path)
Выделяет основное имя из пути
Примеры:
echo basename("/home/somebody/somefile.txt"); // выводит "somefile.txt"
echo basename("/"); // ничего не выводит
echo basename("/."); // выводит "."
echo basename("/./"); // также выводит "."
Функция basename() не проверяет существование файла. Она просто берет часть строки после самого правого слеша и возвращает ее.
Эта функция правильно обрабатывает как прямые, так и обратные слеши под Windows.
dirname
Выделяет имя каталога.
Синтаксис:
string dirname(string $path)
Возвращает имя каталога, выделенное из пути
echo dirname("/home/file.txt"); // выводит "/home"
echo dirname("../file.txt"); // выводит ".."
echo dirname("/file.txt"); // выводит "/" под Unix,
// "" под Windows
echo dirname("/"); // то же самое
echo dirname("file.txt"); // выводит "."
Если функции dirname() передать просто имя файла, она вернет ".", что означает "текущий каталог".
tempnam
Генерирует уникальное имя файла в определенном каталоге.
Синтаксис:
string tempnam(string $dir, string $prefix)
Генерирует имя файла в каталоге
Например, вызов
Если такое имя нужно создать в текущем каталоге, передайте
realpath
Преобразует относительный путь в абсолютный.
Синтаксис:
string realpath(string $path)
Преобразует относительный путь
Пример:
echo realpath("../t.php"); // например, /home/t.php
echo realpath("."); // выводит имя текущего каталога
Файл, который указан в параметре
Функции манипулирования целыми файлами
copy
Копирует файл.
Синтаксис:
bool copy(string $src, string $dst)
Копирует файл с именем
Функция возвращает true, если копирование прошло успешно, а в случае провала - false.
Функция не выполняет переименования файла, если его новое имя расположено в другой файловой системе (на другой смонтированной системе в Unix или на другом диске в Windows).
unlink
Удаление файла.
Синтаксис:
bool unlink(string $filename)
Удаляет файл с именем
Надо заметить, что файл удаляется только в том случае, если число "жестких" ссылок на него стало равным 0. Правда, эта схема специфична для Unix-систем.
file
Считывает файл и разбивает его по строкам.
Синтаксис:
list file(string $filename)
Считывает файл с именем
Неудобство этой функции состоит в том, что символы конца строки (обычно \n), не вырезаются из строк файла, а также не транслируются, как это делается для текстовых файлов.
Другие функции
ftruncate
Усекает файл.
Синтаксис:
bool ftruncate(int $f, int $newsize)
Эта функция усекает открытый файл
Например, следующий код очищает весь файл:
ftruncate($f,0);
fflush
Немедленная запись всех изменений в файле.
Синтаксис:
void fflush(int $f)
Заставляет PHP немедленно записать на диск все изменения, которые производились до этого с открытым файлом
set_file_buffer
Устанавливает размер буфера.
Синтаксис:
int set_file_buffer(int $f, int $size)
Эта функция устанавливает размер буфера, о котором говорилось выше, для указанного открытого файла
Чаще всего она используется так:
set_file_buffer($f,0);
Приведенный код отключает буферизацию для указанного файла, так что теперь все данные, записываемые в файл, немедленно отправляются на диск или в сеть.
flock
Блокирование файла.
Синтаксис:
bool flock(int $f, int $operation [, int $wouldblock])
Функция устанавливает для указанного открытого дескриптора файла
В случае, если был затребован режим без ожидания, и блокировка не была успешно установлена, в необязательный параметр-переменную
В случае ошибки функция возвращает false, а в случае успешного завершения - true.
Функции для работы с каталогами
mkdir
Создание каталога.
Синтаксис:
bool mkdir(string $name, int $perms)
Создает каталог с именем
Пример:
mkdir("my_directory",0755);
// создает подкаталог в текущем каталоге
mkdir("/data");
// создает подкаталог data в корневом каталоге
В случае успеха функция возвращает true, иначе - false.
rmdir
Удаление каталога.
Синтаксис:
bool rmdir(string $name)
Удаляет каталог с именем
Каталог должен быть пустым, а его атрибуты должны позволять это.
В случае успеха функция возвращает true, иначе - false.
chdir
Смена текущего каталога.
Синтаксис:
int chdir(string $directory);
Изменяет текущий PHP каталог на
Примеры:
chdir("/tmp/data"); // переходим по абсолютному пути
chdir("./js"); // переходим в подкаталог текущего каталога
chdir(".."); // переходим в родительский каталог
chdir("~/data"); // переходим в /home/пользователь/data (для Unix)
getcwd
Полный путь.
Синтаксис:
string getcwd()
Данная функция возвращает текущую директорию, относительно которой проводятся файловые операции, т.е. возвращает полный путь к текущему каталогу, начиная от "корня" (/). Если такой путь не может быть отслежен, вызов "проваливается" и возвращается false.
diskfreespace
Определяет свободное пространство в каталоге
Синтаксис:
float diskfreespace (string directory);
Данная функция возвращает в байтах свободное пространство в каталоге
Пример:
$diskspace=diskfreespace("/");
// Тем самым мы определили свободное место в корневой директории "/"
Манипулирование каталогами
mkdir
Создание каталога.
Синтаксис:
bool mkdir(string $name, int $perms)
Создает каталог с именем
Пример:
mkdir("my_directory",0755);
// создает подкаталог в текущем каталоге
mkdir("/data");
// создает подкаталог data в корневом каталоге
В случае успеха функция возвращает true, иначе - false.
rmdir
Удаление каталога.
Синтаксис:
bool rmdir(string $name)
Удаляет каталог с именем
Каталог должен быть пустым, а его атрибуты должны позволять это.
В случае успеха функция возвращает true, иначе - false.
chdir
Смена текущего каталога.
Синтаксис:
int chdir(string $directory);
Изменяет текущий PHP каталог на
Примеры:
chdir("/tmp/data"); // переходим по абсолютному пути
chdir("./js"); // переходим в подкаталог текущего каталога
chdir(".."); // переходим в родительский каталог
chdir("~/data"); // переходим в /home/пользователь/data (для Unix)
getcwd
Полный путь.
Синтаксис:
string getcwd()
Данная функция возвращает текущую директорию, относительно которой проводятся файловые операции, т.е. возвращает полный путь к текущему каталогу, начиная от "корня" (/). Если такой путь не может быть отслежен, вызов "проваливается" и возвращается false.
diskfreespace
Определяет свободное пространство в каталоге
Синтаксис:
float diskfreespace (string directory);
Данная функция возвращает в байтах свободное пространство в каталоге
Пример:
$diskspace=diskfreespace("/");
// Тем самым мы определили свободное место в корневой директории "/"
Работа с записями
dir
Класс каталога (псевдо-объектно ориентированный механизм).
Синтаксис:
new dir(string directory);
Псевдо-объектно ориентированный механизм для получения списка файлов каталога. Открывает каталог из
После этого становятся доступны два свойства объекта: дескриптор каталога
Пример:
$d = dir("/etc");
echo "Handle: ".$d->handle."<br>n";
echo "Path: ".$d->path."<br>n";
while($entry=$d->read()) { // Последовательно выводить
echo $entry."<br>n"; // имя каждого файла,
} // имеющегося в каталоге
$d->close();
closedir
Закрыть дескриптор(handle) каталога.
Синтаксис:
void closedir(int dir_handle);
Закрывает поток каталога, обозначенный как
opendir
Открыть дескриптор каталога.
Синтаксис:
int opendir(string path);
Возвращает дескриптор открытого каталога
readdir
Получение имени следующего файла в списке каталога.
Синтаксис:
string readdir(int dir_handle);
Возвращает имя следующего файла из каталога. Имена файлов возвращаются в виде неупорядоченной последовательности.
Пример:
<?php
$handle=opendir(".");
echo "Directory handle: $handlen";
echo "Files:n";
while ($file = readdir($handle)) {
echo "$filen";
}
closedir($handle);
?>
Следует отметить, что функция также возвращает значения "." и "..". Если эти значения не требуются, то их можно исключить следующим образом:
<?php
$handle=opendir(".");
while($file=readdir($handle)) {
if($file != "." && $file != "..") {
echo "Имя файла: $file<br>";
};
};
closedir($handle);
?>
rewinddir
Реинициализация дескриптора каталога.
Синтаксис:
void rewinddir(int dir_handle);
После вызова этой функции функция readdir() с аргументом
FTP
ftp_connect
Производит подключение к FTP-серверу.
Синтаксис:
int ftp_connect(string host [, int port])
В функции ftp_connect() аргумент
Функция возвращает дескриптор потока FTP или false в случае ошибки.
ftp_pasv
Производит переключение пассивного режима.
Синтаксис:
int ftp_pasv(int ftp_stream, int pasv)
Функция ftp_pasv() производит переключение режима подключения в пассивный, в случае, если аргумент pasv равен true. Если false - то режим подключения будет активный.
В пассивном режиме передача данных инициируется клиентом, а в активном - сервером (это бывает необходимо при блокировке портов у клиента).
Функция возвращает true или false при ошибке.
ftp_login
Производит вход на сервер FTP.
Синтаксис:
int ftp_login(int ftp_stream, string username, string password)
Функция ftp_login() производит регистрацию в системе под именем
ftp_quit
Производит завершение сеанса FTP.
Синтаксис:
int ftp_quit(int ftp_stream)
ftp_pwd
Производит определение текущего каталога.
Синтаксис:
int ftp_pwd(int ftp_stream)
Эта функция возвращает текущий каталог FTP-сервера или false при ошибке.
ftp_cdup
Производит переход в корневой каталог.
Синтаксис:
int ftp_cdup(int ftp_stream)
Функция возвращает true или false при ошибке.
ftp_chdir
Производит переход в каталог.
Синтаксис:
int ftp_chdir(int ftp_stream, string directory)
Функция возвращает true или false при ошибке.
ftp_mkdir
Производит создание каталога.
Синтаксис:
int ftp_mkdir(int ftp_stream, string directory)
Функция возвращает имя созданного каталога или false при ошибке.
ftp_rmdir
Производит удаление каталога.
Синтаксис:
int ftp_rmdir(int ftp_stream, string directory)
Функция true или false при ошибке.
ftp_nlist
Производит получение листинга каталога.
Синтаксис:
int ftp_nlist(int ftp_stream, string directory)
Функция ftp_nlist() возвращает массив файловых имен или false при ошибке.
ftp_rawlist
Получение подробного листинга каталога.
Синтаксис:
int ftp_rawlist(int ftp_stream, string directory)
Функция ftp_rawlist() выполняет FTP-команду
ftp_systype
Возвращает системный идентификатор типа FTP-сервера.
Синтаксис:
int ftp_systype(int ftp_stream)
Функция возвращает строковое значение или false в случае ошибки.
Работа с FTP-сервером
ftp_connect
Производит подключение к FTP-серверу.
Синтаксис:
int ftp_connect(string host [, int port])
В функции ftp_connect() аргумент
Функция возвращает дескриптор потока FTP или false в случае ошибки.
ftp_pasv
Производит переключение пассивного режима.
Синтаксис:
int ftp_pasv(int ftp_stream, int pasv)
Функция ftp_pasv() производит переключение режима подключения в пассивный, в случае, если аргумент pasv равен true. Если false - то режим подключения будет активный.
В пассивном режиме передача данных инициируется клиентом, а в активном - сервером (это бывает необходимо при блокировке портов у клиента).
Функция возвращает true или false при ошибке.
ftp_login
Производит вход на сервер FTP.
Синтаксис:
int ftp_login(int ftp_stream, string username, string password)
Функция ftp_login() производит регистрацию в системе под именем
ftp_quit
Производит завершение сеанса FTP.
Синтаксис:
int ftp_quit(int ftp_stream)
ftp_pwd
Производит определение текущего каталога.
Синтаксис:
int ftp_pwd(int ftp_stream)
Эта функция возвращает текущий каталог FTP-сервера или false при ошибке.
ftp_cdup
Производит переход в корневой каталог.
Синтаксис:
int ftp_cdup(int ftp_stream)
Функция возвращает true или false при ошибке.
ftp_chdir
Производит переход в каталог.
Синтаксис:
int ftp_chdir(int ftp_stream, string directory)
Функция возвращает true или false при ошибке.
ftp_mkdir
Производит создание каталога.
Синтаксис:
int ftp_mkdir(int ftp_stream, string directory)
Функция возвращает имя созданного каталога или false при ошибке.
ftp_rmdir
Производит удаление каталога.
Синтаксис:
int ftp_rmdir(int ftp_stream, string directory)
Функция true или false при ошибке.
ftp_nlist
Производит получение листинга каталога.
Синтаксис:
int ftp_nlist(int ftp_stream, string directory)
Функция ftp_nlist() возвращает массив файловых имен или false при ошибке.
ftp_rawlist
Получение подробного листинга каталога.
Синтаксис:
int ftp_rawlist(int ftp_stream, string directory)
Функция ftp_rawlist() выполняет FTP-команду
ftp_systype
Возвращает системный идентификатор типа FTP-сервера.
Синтаксис:
int ftp_systype(int ftp_stream)
Функция возвращает строковое значение или false в случае ошибки.
Работа с файлами
ftp_get
Производит загрузку с FTP-сервера.
Синтаксис:
int ftp_get(int ftp_stream, string local_file, string remote_file, int mode)
Функция ftp_get() загружает файл под названием
Параметр
Функция возвращает true или false при ошибке.
ftp_fget
Производит загрузку и запись файла.
Синтаксис:
int ftp_fget(int ftp_stream, string fp, string remote_file, int mode)
Функция ftp_fget() загружает файл под названием
Функция возвращает true или false при ошибке.
ftp_put
Производит загрузку файла на FTP-сервер.
Синтаксис:
int ftp_put(int ftp_stream, string remote_file, string local_file, int mode)
Функция ftp_put() загружает файл на FTP-сервер под именем
Функция возвращает true или false при ошибке.
$upload = ftp_put($ftp_id, "C:\file.txt", "/file.txt", FTP_ASCII);
ftp_fput
Производит чтение и загрузку файла на FTP-сервер.
Синтаксис:
int ftp_fput(int ftp_stream, string remote_file, string fp, int mode)
Функция ftp_fput() читает открытый файл с дескриптором
Функция возвращает true или false при ошибке.
ftp_size
Определяет размер файла.
Синтаксис:
int ftp_size(int ftp_stream, string remote_file)
Функция ftp_size() возвращает размер файла, заданного в параметре
ftp_mdtm
Возвращает время последней модификации файла.
Синтаксис:
int ftp_mdtm(int ftp_stream, string remote_file)
Функция ftp_mdtm() возвращает время, последней модификации, представленное в формате Unix, или -1 при ошибке.
Данная функция не работает с каталогами.
ftp_rename
Производит переименование файла.
Синтаксис:
int ftp_rename(int ftp_stream, string from, string to)
Функция ftp_rename() переименовывает файл
Функция возвращает true или false в случае ошибки.
ftp_delete
Производит удаление файла с сервера.
Синтаксис:
int ftp_delete(int ftp_stream, string path)
Функция ftp_delete() удаляет файл, имя которого задано в параметре
Функция возвращает true или false в случае ошибки.
ftp_site
Производит выполнение команды SITE на сервере.
Синтаксис:
int ftp_site(int ftp_stream, string cmd)
Функция ftp_site() посылает серверу команду
Т.к. команды
Функция возвращает true или false в случае ошибки.
Функции сжатия Bzip2
Введение:
Расширение используется для чтения, записи файлов (.bz2), с использованием метода сжатия bzip2.
Требования:
Расширение использует функции библиотеки bzip2 (автор: Julian Seward) и требует bzip2/libbzip2 версий = 1.0.x.
Установка:
Поддержка Bzip2 в PHP не включена по умолчанию. Вам придется скомпилировать PHP с указанием директивы --with-bz2[=DIR].
Настройка во время выполнения:
Данное расширение не определяет никакие директивы конфигурации в php.ini.
Типы ресурсов:
Расширение определяет один новый тип ресурсов: указатель на bz2-файл, с которым идет работа.
Предопределенные константы:
Данное расширение не определяет никакие константы.
Пример:
<?php
$filename = "/tmp/testfile.bz2";
$str = "This is a test string.n";
// открываем файл для записи
$bz = bzopen($filename, "w");
// пишем строку в файл
bzwrite($bz, $str);
// закрываем файл
bzclose($bz);
// открываем файл для чтения
$bz = bzopen($filename, "r");
// читаем и выводим 10 символов
print bzread($bz, 10);
// выводим всё, до конца файла и закрываем его.
print bzread($bz);
bzclose($bz);
?>
Содержание:
Введение
Введение:
Расширение используется для чтения, записи файлов (.bz2), с использованием метода сжатия bzip2.
Требования:
Расширение использует функции библиотеки bzip2 (автор: Julian Seward) и требует bzip2/libbzip2 версий = 1.0.x.
Установка:
Поддержка Bzip2 в PHP не включена по умолчанию. Вам придется скомпилировать PHP с указанием директивы --with-bz2[=DIR].
Настройка во время выполнения:
Данное расширение не определяет никакие директивы конфигурации в php.ini.
Типы ресурсов:
Расширение определяет один новый тип ресурсов: указатель на bz2-файл, с которым идет работа.
Предопределенные константы:
Данное расширение не определяет никакие константы.
Пример:
<?php
$filename = "/tmp/testfile.bz2";
$str = "This is a test string.n";
// открываем файл для записи
$bz = bzopen($filename, "w");
// пишем строку в файл
bzwrite($bz, $str);
// закрываем файл
bzclose($bz);
// открываем файл для чтения
$bz = bzopen($filename, "r");
// читаем и выводим 10 символов
print bzread($bz, 10);
// выводим всё, до конца файла и закрываем его.
print bzread($bz);
bzclose($bz);
?>
Содержание:
Работа с файлами Bzip2
bzclose
Закрывает файл bzip2.
Синтаксис:
int bzclose (resource bz)
Функция bzclose() Закрывает файл bzip2, на который ссылается указатель
Функция возвращает TRUE в случае успешного завершения, FALSE в случае возникновения ошибки.
Указатель должен быть рабочим и должен ссылаться на файл, успешно открытый функцией bzopen().
Функция поддерживается PHP 4 = 4.0.4, PHP 5
bzcompress
Сжимает данные с использованием bzip2.
Синтаксис:
string bzcompress ( string source [, int blocksize [, int workfactor]])
Функция bzcompress() возвращает строку
Опциональный параметр
Опциональный параметр
Пример использования функции bzcompress():
<?php
$str = "sample data";
$bzstr = bzcompress($str, 9);
print( $bzstr );
?>
Функция поддерживается PHP 4 = 4.0.4, PHP 5
bzdecompress
Распаковывает данные, сжатые с использованием bzip2.
Синтаксис:
string bzdecompress ( string source [, int small])
Функция bzdecompress() распаковывает и возвращает
Пример использования функции bzdecompress():
<?php
$start_str = "This is not an honest face?";
$bzstr = bzcompress($start_str);
print( "Compressed String: " );
print( $bzstr );
print( "n<br>n" );
$str = bzdecompress($bzstr);
print( "Decompressed String: " );
print( $str );
print( "n<br>n" );
?>
Функция поддерживается PHP 4 = 4.0.4, PHP 5
bzerrno
Возвращает код ошибки работы с bzip2.
Синтаксис:
int bzerrno ( resource bz)
Функция bzerrno() возвращает код ошибки последней bzip2 функций, отработавшей с указателем
Функция поддерживается PHP 4 = 4.0.4, PHP 5
bzerror
Возвращает код и строку ошибки работы с bzip2.
Синтаксис:
array bzerror ( resource bz)
Функция bzerror() возвращает ассоциативный массив с кодом и строкой ошибки последней bzip2 функции, отработавшей с указателем
Пример использования функции bzerror():
<?php
$error = bzerror($bz);
echo $error["errno"];
echo $error["errstr"];
?>
Функция поддерживается PHP 4 = 4.0.4, PHP 5
bzerrstr
Возвращает строку ошибки работы с bzip2.
Синтаксис:
string bzerrstr ( resource bz)
Функция bzerrstr() возвращает строку ошибки последней bzip2 функции, отработавшей с указателем
Функция поддерживается PHP 4 = 4.0.4, PHP 5
bzflush
Вызывает запись всех буфферизированных данных.
Синтаксис:
sint bzflush ( resource bz)
Функция bzflush() записывает все буфферизированные bzip2 данные в файл, на который ссылается указатель
Возвращает TRUE в случае успешного завершения, FALSE в случае возникновения ошибки.
Функция поддерживается PHP 4 = 4.0.4, PHP 5
bzopen
Открывает для работы файл, сжатый с использованием bzip2.
Синтаксис:
resource bzopen ( string filename, string mode)
Функция bzopen() открывает файл bzip2 (.bz2) для чтения или записи.
При ошибке открытия функция возвращает FALSE, иначе она возвращает указатель на открытый файл.
Пример использования функции bzopen():
<?php
$bz = bzopen("/tmp/foo.bz2", "r");
$decompressed_file = "";
while (!feof($bz)) {
$decompressed_file .= bzread($bz, 4096);
}
bzclose($bz);
print( "The contents of /tmp/foo.bz2 are: " );
print( "n<br>n" );
print( $decompressed_file );
?>
Функция поддерживается PHP 4 = 4.0.4, PHP 5
bzread
Бинарно-безопасное чтение файла bzip2.
Синтаксис:
string bzread ( resource bz [, int length])
Функция bzread() считывает
Пример использования функции bzread():
<?php
$bz = bzopen("/tmp/foo.bz2", "r");
$str = bzread($bz, 2048);
print( $str );
?>
Функция поддерживается PHP 4 = 4.0.4, PHP 5
bzwrite
Бинарно-безопасная запись bzip2 файла.
Синтаксис:
int bzwrite ( resource bz, string data [, int length])
Функция bzwrite() записывает содержание строки
Пример использования функции bzwrite():
<?php
$str = "uncompressed data";
$bz = bzopen("/tmp/foo.bz2", "w");
bzwrite($bz, $str, strlen($str));
bzclose($bz);
?>
Функция поддерживается PHP 4 = 4.0.4, PHP 5
Функции IMAP
Для того, чтобы эти функции заработали вы должны скомпилировать PHP с флагом
Этот флаг требует,чтобы была установлена библиотека c-client. Последнюю версию можно получить по адресу ftp://ftp.cac.washington.edu/imap/.
Затем скопируйте c-client/c-client.a в /usr/local/lib или какую либо другую директорию, прописанную в пути, затем скопируйте c-client/rfc822.h, mail.h и linkage.h в /usr/local/include или другую директорию с include-файлами.
Не смотря на имя модуля, имеющиеся в нем функции позволяют выполнять также много других полезных операций, выходящих за рамки простого использования протокола IMAP. Лежащая в основе библиотека C-клиента также поддерживает NNTP, POP3 и методы доступа к локальным почтовым ящикам.
imap_append
Добавляет текстовое сообщение в указанный почтовый ящик.
Синтаксис:
int imap_append(int imap_stream, string mbox, string message, stringflags);
Возвращает true в случае успеха или false иначе.
imap_append() добавляет текстовое сообщение в указанный почтовый ящик
imap_base64
Декодирует текст, закодированный с помощью BASE64.
Синтаксис:
string imap_base64(string text);
Функция imap_base64() декодирует текст в формате BASE-64. Декодированное сообщение возвращается как строка.
imap_body
Читает тело сообщения.
Синтаксис:
string imap_body(int imap_stream, int msg_number, int flags);
Функция imap_body() возвращает тело сообщения, имеющего номер п/п
Необязательные флаги это битовые маски из
imap_check
Проверяет текущий почтовый ящик.
Синтаксис:
array imap_check(int imap_stream);
Возвращает информацию о текущем почтовом ящике. В случае неуспеха возвращает FALSE.
Функция imap_check() проверяет статус текущего почтового ящика на сервере и возвращает информацию в объекте со следующими свойствами :
imap_close
Закрывает поток IMAP.
Синтаксис:
int imap_close(int imap_stream, int flags);
Закрывает поток imap. Необязательный флаг CL_EXPUNGE заставляет стереть помеченные на удаление сообщения при закрытии.
imap_createmailbox
Создает новый почтовый ящик.
Синтаксис:
int imap_createmailbox(int imap_stream, string mbox);
imap_createmailbox() создает новый почтовый ящик указанный в
imap_delete
Помечает сообщение из текущего почтового ящика на удаление.
Синтаксис:
int imap_delete(int imap_stream, int msg_number);
Возвращает true. Функция imap_delete() помечает сообщение, указанное через
imap_deletemailbox
Удаляет почтовый ящик.
Синтаксис:
int imap_deletemailbox(int imap_stream, string mbox);
Возвращает true в случае успеха и false иначе.
imap_expunge
Удаляет все сообщения, помеченные на удаление.
Синтаксис:
int imap_expunge(int imap_stream);
imap_expunge() удаляет все сообщения помеченные на удаление с помощью imap_delete().
Возвращает true.
imap_fetchbody
Извлекает простую секцию тела сообщения.
Синтаксис:
string imap_fetchbody(int imap_stream, int msg_number, int part_number, flags flags);
Эта функция заставляет извлечь подробную секцию указанного сообщения как текстовую строку. Секция это строка целых чисел, разделенных точками, которые указывают на части тела сообщения в списке частей согласно спецификации IMAP4. Части тела не декодируются этой функцией.
Необязательным параметром к imap_fetchbody() является битовая маска из
imap_fetchstructure
Читает структуру простого сообщения.
Синтаксис:
array imap_fetchstructure(int imap_stream, int msg_number);
Эта функция заставляет извлечь всю информацию о структуре сообщения с номером
Также функция возвращает массив объектов под названием
value - величина
В случае сообщения из нескольких частей, функция также возвращает массив объектов всех свойств под название
imap_header
Читает заголовок сообщения.
Синтаксис:
object imap_header(int imap_stream, int msg_number, int fromlength, int subjectlength, int defaulthost);
Эта функция возвращает объект различных элементов заголовка
imap_headers
Возвращает заголовки всех сообщений в почтовом ящике.
Синтаксис:
array imap_headers(int imap_stream);
Возвращает строковый массив из информации по заголокам. Один элемент массива на сообщение.
imap_listmailbox
Читает список почтовых ящиков.
Синтаксис:
array imap_listmailbox(int imap_stream, string ref, string pat);
Возвращает массив, содержащий названия почтовых ящиков.
imap_listsubscribed
Перечисляет все подписанные ящики.
Синтаксис:
array imap_listsubscribed(int imap_stream, string ref, string pattern);
Возвращает массив всех почтовых ящиков на которые Вы подписаны. Аргументы ref и pattern указывают начальноеместорасположение откуда начинать поиск и шаблон, которому должны удовлетворять названия почтовых ящиков.
imap_mail_copy
Копирует указанные сообщения в почтовый ящик.
Синтаксис:
int imap_mail_copy(int imap_stream, string msglist, string mbox, int flags);
Возвращает true в случае успеха и false иначе.
Копирует почтовые сообщения указанные с помощью msglist в почтовый ящик
Флаги - это битовые маски из
imap_mail_move
Переносит указанные сообщения в почтовый ящик.
Синтаксис:
int imap_mail_move(int imap_stream, string msglist, string mbox);
Переносит почтовые сообщения указанные с помощью
Возвращает true в случае успеха и false иначе.
imap_num_msg
Выдает количество сообщений в текущем почтовом ящике.
Синтаксис:
int imap_num_msg(void);
Возвращает количество сообщений в текущем почтовом ящике.
imap_num_recent
Возвращает количество недавно пришедших сообщений в текущем почтовом ящике.
Синтаксис:
int imap_num_recent(int imap_stream);
imap_open
Подключение к серверу (открытие почтового ящика).
Синтаксис:
int imap_open(string mailbox, string username, string password [, int flags]);
Функция imap_open() возвращает дескриптор почтового ящика IMAP (дескриптор подключения к серверу IMAP) или false при ошибке.
Эта функция может быть использована для открытия потоков к POP3 и NNTP серверам, но в этом случае некоторые функции будут недоступны.
Аргумент
Для того, чтобы присоединиться к серверу IMAP на 143-й порт на локальной машине сделайте следующее:
$mbox = imap_open("{localhost:143}INBOX","user_id","password");
Для того, чтобы подсоединиться к POP3-серверу на 110-й порт на локальном сервере используйте:
$mbox = imap_open("{localhost/pop3:110}INBOX","user_id","password");
Для того, чтобы подсоединиться к NNTP-серверу на 119-й порт на локальном сервере используйте:
$nntp = imap_open("{localhost/nntp:119}comp.test","","");
Для того, чтобы подсоединиться к удаленному серверу замените "localhost" на имя или IP-адрес сервера к которому Вы хотите подсоединиться.
Опции - битовая маска из
imap_ping
Проверяет поток IMAP на работоспособность.
Синтаксис:
int imap_ping(int imap_stream);
Возвращает true если поток еще работоспособен и false иначе.
Функция imap_ping() проверяет поток на работоспособность. Он может также проверять новую почту; это предпочтительный метод для периодической проверки новой почты и "живучести" удаленных серверов.
imap_renamemailbox
Переименовывает старый почтовый ящик в новый.
Синтаксис:
int imap_renamemailbox(int imap_stream, string old_mbox, string new_mbox);
Эта функция переименовывает старый почтовый ящик в новый.Возвращает true в случае успеха и false иначе.
imap_reopen
Заново открывает поток IMAP на новый почтовый ящик.
Синтаксис:
int imap_reopen(string imap_stream, string mailbox, string [flags]);
Возвращает true в случае успеха и false иначе.
Эта функция заново открывает указанный поток на новый ящик.
Опции - битовая маска из
imap_subscribe
Подписывает на почтовый ящик.
Синтаксис:
int imap_subscribe(int imap_stream, string mbox);
Возвращает true в случае успеха и false иначе.
imap_undelete
Снимает отметку с сообщения помеченного на удаление.
Синтаксис:
int imap_undelete(int imap_stream, int msg_number);
Эта функция cнимает отметку с сообщения помеченного на удаление функцией imap_delete().
Возвращает true в случае успеха и false иначе.
imap_unsubscribe
Снимает подписку с почтового ящика.
Синтаксис:
int imap_unsubscribe(int imap_stream, string mbox);
Возвращает true в случае успеха и false иначе.
imap_qprint
Конвертирует строку формата quoted-printable в 8-битовую строку.
Синтаксис:
string imap_qprint(string string);
Возвращает 8-битовую (бинарную) строку.
imap_8bit
Конвертирует 8-битовую строку в формат quoted-printable.
Синтаксис:
string imap_8bit(string string);
Возвращает строку в формате
imap_binary
Конвертирует 8-битную строку в формат base64.
Синтаксис:
string imap_binary(string string);
Возвращает строку в формате base64.
imap_scanmailbox
Читает список почтовых ящиков, проводит поиск в названиях ящиков.
Синтаксис:
array imap_scanmailbox(int imap_stream, string string);
Возвращает массив, содержащий имена почтовых ящиков, которые имеют строку string в названии.
imap_mailboxmsginfo
Получает информацию о текущем почтовом ящике.
Синтаксис:
array imap_mailboxmsginfo(int imap_stream);
Возвращает информацию о текущем почтовом ящике. FALSE в случае неудачи.
Функция imap_mailboxmsginfo() проверяет статус текущего почтового ящика на сервере и возвращает информацию в объекте со следующими свойствами:
imap_rfc822_write_address
Возвращает правильно отформатированный email адрес.
Синтаксис:
string imap_rfc822_write_address(string mailbox, string host, string personal);
Возвращает правильно отформатированный email адрес по данному почтовому ящику, хосту и персональной информации.
imap_rfc822_parse_adrlist
Проводит разбор адресной строки.
Синтаксис:
string imap_rfc822_parse_adrlist(string address, string default_host);
Эта функция разбирает адресную строку и для каждого адреса возвращает массив объектов.
Есть 4 типа объектов:
imap_setflag_full
Устанавливает флаги на сообщения.
Синтаксис:
string imap_setflag_full(int stream, string sequence, string flag, string options);
Эта функция застваляет добавить указанный флаг к набору флагов сообщения в указанной последовательности.
Аргументы последовательности содержат UIDы вместо номеров
imap_clearflag_full
Очищает флаги сообщения.
Синтаксис:
string imap_clearflag_full(int stream, string sequence, string flag, string options);
Эта функция заставляет удалить флаги из набора флагов сообщения в указанной последовательности.
Аргументы последовательности содержат UIDы вместо номеров
imap_sort
Сортирует сообщения в текущем почтовом ящике.
Синтаксис:
Возвращает массив номеров сообщений рассортированных по данному параметру
Критерии сортировки (должен быть указан только один):
опции - битовая маска из
imap_fetchheader
Возвращает заголовок сообщения.
Синтаксис:
string imap_fetchheader(int imap_stream, int msgno, int flags);
Эта функция заставляет извлечь полный, не отфильтрованный заголовок указанного сообщения в формате RFC 822 как текстовую строку.
Опиции:
imap_uid
Эта функция возвращает UID по данному номеру сообщения в последовательности.
Синтаксис:
string imap_uid(string mailbox, int msgno);
Функции SNMP
snmpget
Получает объект SNMP.
Синтаксис:
int snmpget(string hostname, string community, string object_id);
Возвращает значение SNMP объекта при успехе и false при ошибке.
Функция snmpget() используется для чтения значения SNMP объекта, указанного в
SNMP агент определяется именем хоста
snmpget("127.0.0.1", "public", "system.SysContact.0")
snmpwalk
Получает все SNMP объекты у агента.
Синтаксис:
array snmpwalk(string hostname, string community, string object_id);
Возвращает массив значений SNMP объектов начиная с
Функция snmpwalk() используется для чтения всех значений у SNMP агента, определяемого параметром
Нулевой
Если
$a = snmpwalk("127.0.0.1", "public", "");
Указанный выше вызов функции вернет все SNMP объекты из SNMP агента, напущенного на локальном хосте.По всем значениям можно пройти с помощью цикла :
for($i=0; $i<count($a); $i++) {
echo $a[$i];
}
Функции Vmailmgr
Эти функции требуют пакетов QMAIL www.qmail.org и vmailmgr Bruce Guenter
Для всех функций следующие две переменные определяются как: строка
Только до 8 символов распознаются в пароле для виртуальных пользователей.
Возвращается статус для всех функциональных значений ответа в
<?php
dl("php3_vmailmgr.so"); //load the shared library
$vdomain="vdomain.com";
$basepwd="password";
?>
vm_adduser
Добавляет нового виртуального пользователя с паролем.
Синтаксис:
int vm_adduser(string vdomain, string basepwd, string newusername, string newuserpassword);
Добавляет нового виртуального пользователя с паролем.
vm_addalias
Добавляет новый псевдоним для виртуального пользователя.
Синтаксис:
int vm_addalias(string vdomain, string basepwd, string username, string alias);
Добавляет псевдоним виртуальному пользователю.
vm_passwd
Изменяет пароль виртуальных пользователей.
Синтаксис:
int vm_passwd(string vdomain, string username, string password, string newpassword);
Изменяет пароль виртуальных пользователей.
vm_delalias
Удаляет псевдоним.
Синтаксис:
int vm_delalias(string vdomain, string basepwd, string alias);
vm_deluser
Удаляет псевдоним виртуального пользователя.
Синтаксис:
int vm_deluser (string vdomain, string username);
Сетевые функции
ip2long
Производит конвертацию строки адреса IPv4 в число.
Синтаксис:
int ip2long(string ip_address);
Функция ip2long() возвращает четырех байтовое численное представление адреса IP v4 из строки (числа, разделенные точками, например: "127.0.0.1").
// получить IP адрес хоста
$ip=gethostbyname("www.php.net");
echo "Следующие URL эквивалентны:<br>";
echo "http://www.php.net/, http://".$ip.
"/, и http://".ip2long($ip)."/<br>";
long2ip
Производит конвертацию числа в строку адреса IP v4.
Синтаксис:
string long2ip(int proper_address);
Функция long2ip() возвращает строковое представление IP-адреса (в формате: "aaa.bbb.ccc.ddd") из численного представления.
gethostbyaddr
Возвращает имя хоста, который соответствует заданному IP-адресу.
Синтаксис:
string gethostbyaddr(string ip_address);
Функция gethostbyaddr() возвращает доменное имя хоста, заданного своим IP-адресом. В аргументе указывается адрес IP в строковом формате. В случае ошибки возвращает
Надо отметить, что функция не гарантирует, что полученное имя на самом деле будет соответствовать действительности. Она лишь опрашивает хост по адресу
echo gethostbyaddr("127.0.0.1");
gethostbyname
Возвращает IP-адрес хоста.
Синтаксис:
string gethostbyname(string hostname);
Функция gethostbyname() получает в параметрах доменное имя хоста и возвращает его IP-адрес. Если адрес определить не удалось, функция возвращает
gethostbynamel
Возвращает список IP-адресов хоста.
Синтаксис:
array gethostbynamel(string hostname);
Одному доменному имени может соответствовать сразу несколько IP-адресов, и в случае сильной загруженности серверов DNS-сервер сам выбирает, по какому IP-адресу перенаправить запрос. Он выбирает тот адрес, который использовался наиболее редко.
Функция gethostbynamel() возвращает не один, а все IP-адреса хоста с именем
Стоит заметить, что в Интернете существует множество виртуальных хостов, которые имеют различные доменные имена, но один и тот же IP-адресс. Таким образом, если следующая последовательность команд для существующего хоста с IP-адресом ip всегда печатает этот же адрес:
$host = gethostbyaddr($ip);
echo gethostbyname($host);
то аналогичная последовательность для домена с DNS-именем
$ip = gethostbyname($host);
echo gethostbyaddr($ip);
getprotobyname
Производит определение номера порта, используемого протоколом.
Синтаксис:
int getprotobyname(string name);
getprotobynumber
Производит определение протокола порта.
Синтаксис:
string getprotobynumber(int number);
getservbyname
Производит определение протокола интернет-службы.
Синтаксис:
int getservbyname(string service, string protocol);
Эта функция возвращает номер порта, который использует служба
В аргументе
echo getservbyname("HTTP", "TCP"); // может вывести 80
getservbyport
Производит определение интернет-службы, которая использует заданный порт.
Синтаксис:
string getservbyport(int port, string protocol);
Здесь в аргументе
echo getservbyport(21, "TCP"); // выведет: ftp
echo getservbyport(23, "TCP"); // выведет: telnet
checkdnsrr
Производит проверку записи DNS.
Синтаксис:
int checkdnsrr(string host [, string type]);
Эта функция отправляет запрос DNS-серверу для поиска записей, которые имеются для хоста
Аргумент typeможет принимать значения:
Аргумент
getmxrr
Производит получение MX записи для интернет-хоста.
Синтаксис:
int getmxrr(string hostname, array mxhosts [, array weight]);
Функция getmxrr() инициирует поиск в базе данных DNS записи MX (почтовый сервер домена) для хоста
Если запись найдена, возвращает true, если нет - то false.
Список записей MX заносится в массив
Управляющие функции
Отслеживание и обработка ошибок
PHP имеет следующие типы ошибок и предупреждений:
Указанные значения в виде чисел или констант можно комбинировать, формируя битовую маску ошибок, о которых необходимо сообщать в ходе исполнения сценария. Для комбинирования используются битовые операторы, но в конфигурационном файле php.ini распознаются только "|", "~", "!" и "&".
В PHP 4 по умолчанию разрешены сообщения вида E_ALL & ~E_NOTICE, то есть сообщаться должно все, кроме обычных сообщений. Можно переопределить эту установку параметром файла конфигурации error_reporting() (ее также можно указывать в файлах конфигурации сервера Apache).
Если при вызове функции перед ее именем указать символ "@", то в случае возникновения ошибки в этой функции сообщение о нем выдаваться не будет.
В настоящее время оператор игнорирования ошибок блокирует даже выдачу сообщений о критических ошибках, при возникновении которых сценарий досрочно завершается.
Если разрешен параметр конфигурации
<?php
// определенный пользователем обработчик ошибок
function userErrorHandler($errno,$errmsg,$filename,$linenum,$vars) {
// время возникновения ошибки
$dt=date("Y-m-d H:i:s (T)");
$errortype = array(
1 => "Error",
2 => "Warning",
4 => "Parsing Error",
8 => "Notice",
16 => "Core Error",
32 => "Core Warning",
64 => "Compile Error",
128 => "Compile Warning",
256 => "User Error",
512 => "User Warning",
1024 => "User Notice"
);
$err.="время ($dt), номер ошибки ($errno), ";
$err.="тип ошибки (".$errortype[$errno]."): ";
$err.=""$errmsg".файл "$filename", строка (";
$err.=$linenum.")n";
$user_errors=array(E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE);
if(in_array($errno, $user_errors))
// выдать сообщение для ошибок пользователя
echo $err;
// сохранить событие ошибки в системном журнале
error_log($err, 3, "/usr/local/php4/error.log");
}
// установить уровень контроля ошибок и обработчик
error_reporting(0); // не выводить сообщения PHP
$old_error_handler=set_error_handler("userErrorHAndler");
// неопределенная константа вызывает предупреждение
$t=_NOT_DEFINED_CONSTANT;
trigger_error("Моя ошибка", E_USER_ERROR);
trigger_error("Мое предупреждение", E_USER_WARNING);
?>
Введение
PHP имеет следующие типы ошибок и предупреждений:
Указанные значения в виде чисел или констант можно комбинировать, формируя битовую маску ошибок, о которых необходимо сообщать в ходе исполнения сценария. Для комбинирования используются битовые операторы, но в конфигурационном файле php.ini распознаются только "|", "~", "!" и "&".
В PHP 4 по умолчанию разрешены сообщения вида E_ALL & ~E_NOTICE, то есть сообщаться должно все, кроме обычных сообщений. Можно переопределить эту установку параметром файла конфигурации error_reporting() (ее также можно указывать в файлах конфигурации сервера Apache).
Если при вызове функции перед ее именем указать символ "@", то в случае возникновения ошибки в этой функции сообщение о нем выдаваться не будет.
В настоящее время оператор игнорирования ошибок блокирует даже выдачу сообщений о критических ошибках, при возникновении которых сценарий досрочно завершается.
Если разрешен параметр конфигурации
<?php
// определенный пользователем обработчик ошибок
function userErrorHandler($errno,$errmsg,$filename,$linenum,$vars) {
// время возникновения ошибки
$dt=date("Y-m-d H:i:s (T)");
$errortype = array(
1 => "Error",
2 => "Warning",
4 => "Parsing Error",
8 => "Notice",
16 => "Core Error",
32 => "Core Warning",
64 => "Compile Error",
128 => "Compile Warning",
256 => "User Error",
512 => "User Warning",
1024 => "User Notice"
);
$err.="время ($dt), номер ошибки ($errno), ";
$err.="тип ошибки (".$errortype[$errno]."): ";
$err.=""$errmsg".файл "$filename", строка (";
$err.=$linenum.")n";
$user_errors=array(E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE);
if(in_array($errno, $user_errors))
// выдать сообщение для ошибок пользователя
echo $err;
// сохранить событие ошибки в системном журнале
error_log($err, 3, "/usr/local/php4/error.log");
}
// установить уровень контроля ошибок и обработчик
error_reporting(0); // не выводить сообщения PHP
$old_error_handler=set_error_handler("userErrorHAndler");
// неопределенная константа вызывает предупреждение
$t=_NOT_DEFINED_CONSTANT;
trigger_error("Моя ошибка", E_USER_ERROR);
trigger_error("Мое предупреждение", E_USER_WARNING);
?>
Функции обработки ошибок
error_log
Посылка сообщения об ошибке.
Синтаксис:
int error_log(string message, int message_type [, string destination [, string extra_headers]])
Сообщение, посылаемое этой функцией, может быть направлено в журнал системных сообщений web-сервера, прот TCP или в файл.
В первом аргументе
Назначение обозначается следующими значениями:
if(!Ora_London($username, $password)) {
error_log("Сервер Oracle недоступен!", 0);
};
if(!($foo = allocate_new_foo()) {
error_log("Нельзя выделить FOO!", 1, "operator@mydomain.ru");
}
// other ways of calling error_log():
error_log("У нас ошибка!", 2, "127.0.0.1:7000");
error_log("У нас ошибка!", 2, "localhost");
error_log("У нас ошибка!", 3, "/var/tmp/my-errors.log");
error_reporting
Установка видов сообщаемых ошибок.
Синтаксис:
int error_reporting([int level])
Функция error_reporting() возвращает предыдущую установку типа сообщаемых ошибок. Если указан аргумент, то заново переопределяет ее. В аргументе можно указывать константу, число или битовую маску. Старайтесь использовать константы вместо численных значений, чтобы сохранить совместимость с будущими версиями PHP.
error_reporting(2039); // в PHP эквивалент E_ALL ^ E_NOTICE
error_reporting(E_ALL ^ E_NOTICE); // установка по умолчанию
error_reporting(0); // отключить сообщения об ошибках
// общие ошибки выполнения
error_reporting(E_ERROR | E_WARNING | E_PARSE);
// также сообщать о неизвестных переменных
error_reporting(E_ERROR | E_WARNING | E_PARSE | E_NOTICE);
error_reporting(E_ALL); // сообщать все ошибки
restore_error_handler
Восстановление предыдущего обработчика ошибок.
Синтаксис:
void restore_error_handler()
Эта функция устанавливает в качестве функции обработчика ошибок ту, которая была таковой до последнего вызова функции set_error_handler(). Предыдущим обработчиком может быть ранее установленный пользовательский обработчик или встроенный обработчик PHP.
trigger_error
Генерация ошибки.
Синтаксис:
void trigger_error(string error_msg [, int error_type])
Явно вызывает функцию, установленную для обработки ошибок, и обычно используется в паре с обработчиком ошибок. Функция способна генерировать только пользовательские типы ошибок ( семейство констант E_USER), и по умолчанию, если не указан тип ошибки
Возможно конструировать сложные конструкции генерации и обработки ошибок и исключительных ситуаций.
if(assert($divisor == 0))
trigger_error ("Нельзя делить на 0 ", E_USER_ERROR);
user_error
Синоним функции trigger_error().
Синтаксис:
void user_error(string error_msg [, int error_type])
Установка пользовательского обработчика ошибок
set_error_handler
Установка пользовательского обработчика ошибок.
Синтаксис:
string set_error_handler(string error_handler)
Функция возвращает имя функции, ранее определенной в качестве обработчика ошибок (или FALSE при ошибке), и устанавливает, в качестве нового обработчика, функцию с указанным в аргументе
Обычно пользовательский обработчик ошибок работает в паре с функцией trigger_error(), генерирующей ошибку. Это может быть использовано (подобно аналогичной конструкции работы с исключениями в C) для освобождения выделенных ресурсов (например, удаления созданных файлов), если сценарий не может нормально завершиться.
Функция, устанавливаемая в качестве обработчика ошибок, должна принимать пять параметров (три последних являются дополнительными и могут не обрабатываться):
<?php
// определить константы пользовательских ошибок
define(FATAL, E_USER_ERROR);
define(ERROR, E_USER_WARNING);
define(WARNING, E_USER_NOTICE);
// установить, какие ошибки должны обрабатываться в сценарии
error_reporting (FATAL | ERROR | WARNING);
// пользовательский обработчик ошибок
function myErrorHandler($errno,$errstr,$errfile,$errline) {
switch ($errno) {
case FATAL:
echo "<b>Критическая ошибка</b> [$errno] $errstr<br>n";
echo "в строке: $errline файла:".$errfile;
echo ", PHP ".PHP_VERSION." (".PHP_OS.")<br>n";
echo "Aborting...<br>n";
exit -1;
break;
case ERROR:
echo "<b>Ошибка</b> [$errno] $errstr<br>n";
break;
case WARNING:
echo "<b>Предупреждение</b> [$errno] $errstr<br>n";
break;
default:
echo "Неизвестный тип ошибки: [$errno] $errstr<br>n";
}
}
// функция для проверки обработки ошибок
// (масштабирование массива
function scale_by_log($vect, $scale) {
if(!is_numeric($scale) || $scale <= 0)
trigger_error("вычислить log(x) для x <= 0 нельзя. ",
"(x = $scale)", FATAL);
if(!is_array($vect)) {
trigger_error("Требуется массив ", ERROR);
return null;
}
for($i=0; $i<count($vect); $i++) {
if(!is_numeric($vect[$i]))
trigger_error("Элемент ($i) не число и
его значением считается 0", WARNING);
$temp[$i]=log($scale)*$vect[$i];
}
return $temp;
}
// установить пользовательский обработчик ошибок
$old_error_handler=set_error_handler("myErrorHandler");
$a=array(2,3,"foo",5.5,43.3,21.11);
print_r($a);
$b=scale_by_log($a,M_PI); // здесь выдается предупреждение
echo "Массив, масштабированный на логарифм(Пи): ";
print_r($b);
$c=scale_by_log("not array",2,3); // здесь ошибка
var_dump($c);
$d=scale_by_log($a, -2.5); // здесь критическая ошибка
echo "Продолжение сценария...";
?>
При выполнении сценария вывод будет следующим:
Array( [0] => 2 [1] => 3 [2] => foo [3] => 5.5 [4] => 43.3 [5] => 21.11)Предупреждение [1024] Элемент (2) не число, и его значением считается 0<br>Массив, масштабированный на логарифм(Пи): Array( [0] => 2.2894597716988 [1] => 3.4341896575482 [2] => 0 [3] => 6.2960143721717 [4] => 49.566804057279 [5] => 24.165247890281)<b>Ошибка</b> [512] Требуется массив <br>NULL<b>Критическая ошибка</b> [256] вычислить log(x) для x <=0 нельзя, (x = -2.5)<br> в строке: 37, файла E:wwwexampl.php, PHP 4.0.5 (WINNT)<br>Aborting...<br>
Не забывайте, что при установке пользовательского обработчика ошибок стандартный обработчик PHP не используется. Установки error_reporting() также не будут иметь эффекта, и пользовательский обработчик должен уметь обрабатывать все виды ошибок (значение error_reporting() можно выяснить и действовать соотвественно). Заметьте, что код ошибки будет равен 0, если ошибка возникла в функции, вывод ошибок для которой был блокирован оператором "@".
Также помните, что завершать сценарий в обработчике необходимо явно (например, с помощью функции die(), если, конечно, в этом есть необходимость. Если обработчик ошибок завершается с помощью return, то выполнение сценария продолжается с того места, в котором возникла ошибка (то есть исполняются инструкции, которые следуют за той инструкцией, в которой возникла ошибка).
Управление сессиями
Зачем нужны сессии
Сессия представляет собой механизм, позволяющий хранить некоторые данные, индивидуальные для каждого пользователя (например, его имя и номер счета), между запусками сценария.
В Web-программировании есть один класс задач, который может вызвать довольно много проблем, если писать сценарий "в лоб". Речь идет о слабой стороне CGI - невозможности запустить программу на длительное время, позволив ей при этом обмениваться данными с пользователями.
Представте, что мы пишем форму, но в ней такое большое число полей, что было бы глупо поместить их на одну страницу. Нам нужно разбить процесс заполнения формы на несколько этапов, или стадий, и представить их в виде отдельных HTML-документов.Например, в первом документе с диалогом у пользователя может запрашиваться его имя и фамилия, во втором - данные о его месте жительства, и в третьем - номер кредитной карточки. В любой момент можно вернуться на шаг назад, чтобы исправить те или иные данные. Наконец, если все в порядке, накопленная информация обрабатывается - например, помещается в базу данных.
Реализация такой схемы оказывается для Web-приложений довольно нетривиальной проблемой. Действительно, нам придется хранить все ранее введенные данные в каком-нибудь хранилище, которое должно аннулироваться, если пользователь вдруг передумает и уйдет с сайта. Для этого можно использовать функции сериализации и файлы. Однако ими мы решаем только половину проблемы: нам нужно как то привязать конкретного пользователя к конкретному временному хранилищу. Действительно, предположим, мы этого не сделали. Тогда, если в момент заполнения какой-нибудь формы одним пользователем на сайт зайдет другой и тоже попытается ввести свои данные, получится белеберда.Все эти проблемы решаются при помощи сессий.
Механизм работы сессий
Для начала должен существовать механизм, который бы позволил PHP идентифицировать каждого пользователя, запустившего сценарий. То есть при следующем запуске PHP нужно однозначно определить, кто его запустил: тот же человек, или другой. Делается это путем присвоения клиенту так называемого уникального идентификатора сессии. Чтобы этот идентификатор был доступен при каждом запуске сценария, PHP помещает его Cookies браузера. Теперь, зная идентификатор (дальше SID), PHP может определить, в каком же файле на диске хранятся данные пользователя.
Немного о том, как сохранять переменную (обязательно глобальную) в сессии. Для этого мы должны ее зарегистрировать с помощью специальной функции. После регистрации мы можем быть уверены, что при следующем запуске сценария тем же пользователем она получит то же самое значение, которое было у нее при предыдущем завершении программы. Это произойдет потому, что при завершении сценария PHP автоматически сохраняет все переменные, зарегистрированные в сессии, во временное хранилище. Конечно, можно в любой момент аннулировать переменную - вычеркнуть ее из сессии, или же уничтожить вообще все данные сессии.
Где же находиться то промежуточное хранилище, которое использует PHP? Вообще говоря, вы вольны сами это задать, написав соответствующие функции и зарегистрировав их как обработчики сессии. Впрочем, делать это не обязательно: в PHP уже существуют обработчики по умолчанию, которые хранят данные в файлах. Если вы не собираетесь создавать что-то особенное, вам они вполне подойдут.
Зачем нужны сессии.Механизм работы сессий.
Зачем нужны сессии
Сессия представляет собой механизм, позволяющий хранить некоторые данные, индивидуальные для каждого пользователя (например, его имя и номер счета), между запусками сценария.
В Web-программировании есть один класс задач, который может вызвать довольно много проблем, если писать сценарий "в лоб". Речь идет о слабой стороне CGI - невозможности запустить программу на длительное время, позволив ей при этом обмениваться данными с пользователями.
Представте, что мы пишем форму, но в ней такое большое число полей, что было бы глупо поместить их на одну страницу. Нам нужно разбить процесс заполнения формы на несколько этапов, или стадий, и представить их в виде отдельных HTML-документов.Например, в первом документе с диалогом у пользователя может запрашиваться его имя и фамилия, во втором - данные о его месте жительства, и в третьем - номер кредитной карточки. В любой момент можно вернуться на шаг назад, чтобы исправить те или иные данные. Наконец, если все в порядке, накопленная информация обрабатывается - например, помещается в базу данных.
Реализация такой схемы оказывается для Web-приложений довольно нетривиальной проблемой. Действительно, нам придется хранить все ранее введенные данные в каком-нибудь хранилище, которое должно аннулироваться, если пользователь вдруг передумает и уйдет с сайта. Для этого можно использовать функции сериализации и файлы. Однако ими мы решаем только половину проблемы: нам нужно как то привязать конкретного пользователя к конкретному временному хранилищу. Действительно, предположим, мы этого не сделали. Тогда, если в момент заполнения какой-нибудь формы одним пользователем на сайт зайдет другой и тоже попытается ввести свои данные, получится белеберда.Все эти проблемы решаются при помощи сессий.
Механизм работы сессий
Для начала должен существовать механизм, который бы позволил PHP идентифицировать каждого пользователя, запустившего сценарий. То есть при следующем запуске PHP нужно однозначно определить, кто его запустил: тот же человек, или другой. Делается это путем присвоения клиенту так называемого уникального идентификатора сессии. Чтобы этот идентификатор был доступен при каждом запуске сценария, PHP помещает его Cookies браузера. Теперь, зная идентификатор (дальше SID), PHP может определить, в каком же файле на диске хранятся данные пользователя.
Немного о том, как сохранять переменную (обязательно глобальную) в сессии. Для этого мы должны ее зарегистрировать с помощью специальной функции. После регистрации мы можем быть уверены, что при следующем запуске сценария тем же пользователем она получит то же самое значение, которое было у нее при предыдущем завершении программы. Это произойдет потому, что при завершении сценария PHP автоматически сохраняет все переменные, зарегистрированные в сессии, во временное хранилище. Конечно, можно в любой момент аннулировать переменную - вычеркнуть ее из сессии, или же уничтожить вообще все данные сессии.
Где же находиться то промежуточное хранилище, которое использует PHP? Вообще говоря, вы вольны сами это задать, написав соответствующие функции и зарегистрировав их как обработчики сессии. Впрочем, делать это не обязательно: в PHP уже существуют обработчики по умолчанию, которые хранят данные в файлах. Если вы не собираетесь создавать что-то особенное, вам они вполне подойдут.
Инициализация сессии и регистрация переменных
session_start
Эта функция инициализирует механизм сессий для текущего пользователя, запустившего сценарий.
Синтаксис:
void session_start()
Если посетитель запускает программу впервые, у него устанавливается Cookies с уникальным идентификатором, и создается временное хранилище, ассоциированное с этим идентификатором. Определяется, какое хранилище связано с текущим идентификатором пользователя. Если в хранилище имеются какие-то переменные, их значения восстанавливаются. Точнее, создаются глобальные переменные, которые были сохранены в сессии при предыдущем завершении сценария.
Надо заметить, что если вы поставили в настройках PHP режим
Функция всегда возвращает true.
session_register
Указывает PHP на то, что ту или иную переменную нужно сохранить в сессии.
Синтаксис:
bool session_register(mixed name [, mixed name1, ...])
Функция принимает в параметрах одно или несколько имен переменных (имена задаются в скобках, без знака $ слева), регистрируют их в текущей запущенной сессии и возвращает true, если регистрация прошла успешно.
Повторная запись одной переменной в сессии не приведет к ошибке.
<?php
session_start();
session_register("count");
$count=@$count+1;
?>
<h2>Счетчик</h2>
В текущей сессии работы с браузером вы открыли эту страницу
<?=$count?> раз(а). Закройте браузер, чтобы обнулить счетчик.
</body>
Имя группы сессии
Надо отметить, что на одном и том же сайте могут существовать сразу несколько сценариев, которые нуждаются в услугах поддержки сессий PHP. Они "ничего не знают" друг о друге, поэтому временные хранилища для сессий должны выбираться не только на основе идентификатора пользователя, но и на основе того, какой из сценариев запросил обслуживание сессии.
Для наглядности рассмотрим пример:
Пусть разработчик А написал сценарий счетчика. Он использует переменную
Нам нужно как-то разграничить сессии, принадлежащие одному сценарию, от сессии, принадлежащих другому. К счастью, разработчики PHP предусмотрели такое положение вещей. Мы можем давать группам сессии непересекающиеся имена, и сценарий, знающий имя своей группы сессии, сможет получить к ней доступ. Вот теперь-то разработчики А и В могут оградить свои сценарии от проблем с пересечением имен переменных. Достаточно в первой программе указать PHP, что мы хотим использовать группу с именем, например, sesA, а во второй - sesB.
session_name
Эта функция устанавливает или возвращает имя группы сессии, которая будет использоваться PHP для хранения зарегистрированных переменных.
Синтаксис:
string session_name([string $newname])
Если
Отметим, что session_name() лишь сменяет имя текущей группы и сессии, но не создает новую сессию и временное хранилище. Это значит, что мы должны в большинстве случаев вызывать session_name(имя_группы) еще до ее инициализации - вызова session_start(), в противном случае мы получим совсем не то, что ожидали.
Если функция session_name() не была вызвана по инициализации, PHP будет использовать имя по умолчанию - PHPSESID.
Пример:
<?php
session_name("CounterScript"
session_start();
session_register("count");
$count=@$count+1;
?>
В текущей сессии вы открыли эту страницу
Идентификатор сессии
Итак, идентификатор сессии является именем временного хранилища, которое будет использовано для хранения данных сессии между запусками сценария. Один SID - одно хранилище. Нет SID, нет и хранилища, и наоборот.
Так как же соотносится идентификатор и имя группы? Имя - это всего лишь собирательное название для нескольких сессий (то есть, для многих SID), запущенных разными пользователями. Один и тот же клиент никогда не будет иметь два различных SID в пределах одного имени группы. Но его браузер вполне может работать с несколькими SID, расположенными логически в разных "пространствах имен".
Итак, все SID уникальны и однозначно определяют сессию на компьютере, выполняющем сценарий - независимо от имени сессии. Имя же задает пространство имен, в которое будут сгруппированы сессии, запущенные разными пользователями. Один клиент может иметь сразу несколько активных пространств имен (то есть несколько имен групп сессий).
session_id
Эта функция возвращает текущий идентификатор сессии SID.
Синтаксис:
string session_id([string $sid])
Если задан параметр
Вызвав session_id() до session_start(), мы можем подключиться к любой (в том числе и к чужой) сессии на сервере, если знаем ее идентификатор. Мы можем также создать сессию с угодным нам идентификатором, при этом автоматически установив его в Cookies пользователя.
Другие функции
session_is_registered
Проверяет, зарегистрирована или нет та или иная переменная.
Синтаксис:
bool session_is_registered(string $name)
Функция возвращает true, если переменная с именем
session_unregister
Отменяет регистрацию переменной.
Синтаксис:
bool session_unregister(string $name)
Эта функция отменяет регистрацию для переменной с именем
Возвращает true, если все прошло успешно, и false - в противном случае.
Отметим, что после вызова функции session_unregister() глобальная переменная, которая была "аннулирована", не уничтожается, а сохраняет свое значение.
session_unset
Отменяет регистрацию и уничтожает глобальные переменные.
Синтаксис:
void session_unset()
Эта функция, в отличии от session_unregister(), не только отменяет регистрацию переменных (всех переменных сессии, а не только какой-то одной), но и уничтожает глобальные переменные, которые были зарегестрированы в сессии.
session_save_path
Имя каталога, в котором будут храниться файлы с данными из сессий.
Синтаксис:
string session_save_path([string $path])
Эта функция возвращает имя каталога, в котором будут помещаться файлы - временные хранилища данных сессии. В случае, если указан параметр, активное имя каталога будет переустановлено на
Обзор обработчиков
handler_open
Этот обработчик должен взять на себя всю работу по открытию базы данных для группы сессий с именем, которое было передано ей в параметрах.
Синтаксис:
bool handler_open(string $save_path, string $session_name)
Функция вызывается, когда вызывается session_start(). Обработчик должен взять на себя всю работу, связанную с открытием базы данных для группы сессий с именем
handler_close
Этот обработчик вызывается, когда данные сессии записаны во временное хранилище и его нужно закрыть.
Синтаксис:
bool handler_close()
handler_read
Чтение данных сессии.
Синтаксис:
string handler_read(string $sid)
Этот обработчик вызывают, когда нужно прочитать данные сессии с идентификатором
Возвращаемые данные представлены в следующем виде:
имя1=значение1;имя2=значение2;имя3=значение3;...
Например, наша запись может иметь следующий вид:
foo|i:1;count|i:10;
Она говорит о том, что из временного хранилища были прочитаны две целые переменные, первая из которых равна 1, а вторая - 10.
handler_write
Запись данных сессии.
Синтаксис :string handler_write(string $sid, string $data)
Этот обработчик предназначен для записи данных сессии с идентификатором
handler_gc
Очищает временное хранилище данных через определенный промежуток времени.
Синтаксис:
bool handler_gc(int $maxlifetime)
Этот обработчик вызывается каждый раз при завершении работы сценария. Если пользователь окончательно покинул сервер, значит, данные сессии во временном хранилище можно уничтожить. Этим и должна заниматься функция handler_gc(). Ей передается в параметрах то время (в секундах), по прошествии которого PHP принимает решение о необходимости удалить все ненужные данные.
session_set_save_handler
Регистрация обработчиков.
При описании обработчиков мы указывали их имена с префиксом
Но возникает вопрос: как же тогда PHP их найдет? Вот для этого и существует функция регистрации обработчиков, которая говорит интерпретатору, какую функцию он должен вызывать при наступлении того или иного события.
Синтаксис:
void session_set_save_handler($open, $close, $read, $write, $destroy, $gc)
Эта функция регистрирует подпрограммы, имена которых переданы в ее параметрах, как обработчики текущих сессии. Параметр
Эту функцию можно вызывать только до инициализации сессии, в противном случае она просто игнорируется.
Про сессии и Cookies
Проблема: - отключены Cookies
Бытует распространенное мнение, что сессии без Cookies не может существовать. Действительно, Cookies наиболее просто решает проблему идентификации пользователя, что необходимо для связи временного хранилища и данных сессии. Но вот что делать, если пользователь у себя в настройках отключил прием Cookies?
На этот случай разработчики PHP позаботились о передаче идентификаторов сессии не в Cookies, а каким-нибудь аналогичным путем, например через адресную строку броузера.
Решение: - изменение гиперссылок и форм
В PHP существует одна специальная константа с именем SID. Она всегда содержит имя группы сессии и ее идентификатор в формате имя=идентификатор. Именно в таком формате данные принимаются, когда они приходят из Cookies браузера. Таким образом, нам достаточно просто передать значение константы SID в сценарий, чтобы он "подумал", будто бы данные пришли из Cookies.Вот пример использования сессий без Cookies:
<?php
session_name("testses");
session_start();
session_register("i");
$i=@$i+1;
?>
<body>
Вы открыли эту страницу
<?=$i?> раз. При закрытии браузера счетчик обнулиться.<BR>
<A href=sesclick.php?<?=SID?>>Нажмите для записи в счетчик!</A>
</body>
Этот пример будет работать, если у пользователя действительно отключены Cookies. Если они включены, PHP просто не будет генерировать константу SID и задействует Cookies.
Но в приведенном способе есть одно неудобство, а именно, везде в участки кода нужно вставлять
К счастью, разработчики PHP учли эту возможность, и решили уберечь нас от этого. По-этому если в какой-нибудь гиперссылке вы по ошибке пропустите
Для проверки можно использовать следующий пример:
<?session_start()?>
<body>
<A href="php.php">PHP</A>
<A href="php.php?ss=1">PHP - выражения</A>
Вот что получиться, при наведении мышки на эти ссылки:
http://www.spravkaweb.ru/php.php?PHPSESSID=81456f6a886f2104http://www.spravkaweb.ru/php.php?ss=1&PHPSESSID=34f5d04a35601510f45
В PHP существует еще одна возможность использовать сессии с отключенными Cookies - добавление скрытых полей в формы, которые формируют сценарий, чтобы передать идентификатор сессии вызываемому документу.
Приведем пример, который выявляет эту возможность:
<?session_start()?>
<form action=act.php mathod=post>
</form>
А вот что получиться при просмотре нашей страницы в виде HTML:
<form action="act.php" method="post"><INPUT TYPE=HIDDEN NAME="PHPSESSID" VALUE="0a561093f84d4321"></form>
Из примера мы видим, что PHP добавил в форму скрытое поле с нужным именем и значением.
Работа с WWW
Header
Вывод заголовка.
Синтаксис:
int Header(string $string)
Обычно функция Header() является одной из первых команд сценария. Она предназначена для установки заголовков ответа, которые будут переданы браузеру - по одному заголовку на вызов. Вызов Header() обязательно должен осуществляться до любого оператора вывода в сценарии - в противном случае вы получете предупреждение. Текст вне <? и ?> также рассматривается как оператор вывода.
Пример:
// перенаправляет браузер на сайт PHP
Header("Location: http://www.php.net");
// теперь принудительно завершаем сценарий, ввиду того, что после
// перенаправления больше делать нечего
exit;
Смотреть также
Установка заголовков ответа
Header
Вывод заголовка.
Синтаксис:
int Header(string $string)
Обычно функция Header() является одной из первых команд сценария. Она предназначена для установки заголовков ответа, которые будут переданы браузеру - по одному заголовку на вызов. Вызов Header() обязательно должен осуществляться до любого оператора вывода в сценарии - в противном случае вы получете предупреждение. Текст вне <? и ?> также рассматривается как оператор вывода.
Пример:
// перенаправляет браузер на сайт PHP
Header("Location: http://www.php.net");
// теперь принудительно завершаем сценарий, ввиду того, что после
// перенаправления больше делать нечего
exit;
Смотреть также
Получение заголовков запроса
getallheaders
Получение всех заголовков запроса.
Синтаксис:
array GetAllHeaders()
Функция GetAllHeaders() возвращает ассоциативный массив, содержащий данные о HTTP-заголовках запроса клиента, породившего запуск сценария. Ключи массива содержат названия заголовков, а значения - их величины.
$headers = GetAllHeaders();
foreach($headers as $header=>$value)
echo "$header: $value<br>n";
Функция GetAllHeaders() поддерживается PHP только в том случае, если он установлен в виде модуля Apache. В противном случае этой функции просто не будет (да и не может быть, потому что обычный CGI-сценарий не имеет доступа к заголовкам запроса). В частности, в PHP для Windows (который чаще всего реализуют именно в виде сценария) функция GetAllHeaders() недоступна.
Работа с Cookies
Немного теории
Cookie - это именованная порция информации, которая может сохраняться прямо в настройках браузера пользователя между сеансами. Причина, по которой применяются Cookies - большое количество посетителей вашего сервера, а также нежелание иметь нечто подобное базе данных для хранения информации о каждом посетителе. Поиск в такой базе данных может очень и очень затянуться, и, в тоже время, нет никакого смысла централизованно хранить столь отрывочные сведения. Использование Cookies фактически перекладывает задачу на плечи браузера, решая одним махом как проблему быстродействия, так и проблему большого объема базы данных с информацией о пользователе.
Самый распространенный прием применения Cookies - логин и пароль пользователя, использующего некоторые защищенные ресурсы вашего сайта. Эти данные, конечно же, между открытиями страниц хранятся в Cookies, для того чтобы пользователю не пришлось их каждый раз набирать вручную заново.
У каждого Cookies есть определенное время жизни, по истечении которого он автоматически уничтожается. Существуют также Cookies, которые "живут" только в течение текущего сеанса работы с браузером.
Каждый Cookie устанавливается сценарием на сервере. Для этого он должен послать браузеру специальный заголовок вида:
Set-cookie: данные
Сценарии с других серверов, а также расположенные в другом каталоге, не будут извещены о "чужих" Cookies. Для них их словно и нет. И это правильно с точки зрения безопасности - кто знает, насколько секретна может быть информация, сохраненная в Cookies?
Получение Cookie
Предположим, сценарий отработал и установил какой-то Cookie, например, с именем Cook и значением
setcookie
Установка Cookie.
Синтаксис:
int setcookie(string $name [,string $value] [,int $expire] [,string $path] [,string $domain] [,book $secure])
Так как Cookie фактически представляет собой заголовок, установить его можно только перед первой командой вывода в сценарий.
Вызов setcookie() определяет новый Cookie, который тут же посылается браузеру вместе с остальными заголовками. Все аргументы, кроме имени, необязательны. Если задан только параметр
Параметр
Параметр
Примеры:
// Cookie на одну сессию, т.е. до закрытия браузера
SetCookie("TextCookie","value");
// Эти Cookies уничтожаются браузером через 1 час после установки
SetCookie("TextCookie",$val,time()+3600);
SetCookie("TextCookie",$val,time()+3600,"/~rasmus/",".utoronto.ca",1);
После вызова SetCookie() только что созданный Cookie сразу появляется среди глобальных переменных как переменная с заданным в параметре
SSI и функция virtual()
Немного теории
Для одного и того же документа в Apache нельзя применять два "обработчика". Иными словами, действует принцип: либо PHP, либо SSI.
Однако в PHP имеются определенные средства для "эмуляции" SSI-конструкции
Конструкция
virtual
Имитация include virtual.
Синтаксис:
int virtual(string $url)
Функция virtual() представляет собой процедуру, которая может поддерживаться только в случае, если PHP установлен как модуль Apache. Она делает то же самое, что и SSI-инструкция
Чаше всего функция virtual() используется для запуска внешних CGI-сценариев, написанных на другом языке программирования, или же для обработки SSI-файлов более сложной структуры. В случае, если запускается сценарий, он должен генерировать правильные HTTP-заголовки, иначе будет выведено сообщение об ошибке. Для включения обычных PHP-файлов с участками кода функция virtual() неприменима - это выполняет оператор include.
Управление выводом
Данная группа функций позволяет управлять тем, как PHP при выполнении сценария выводит информацию. Это может быть полезно в различных ситуациях, в особенности при посылке браузеру HTML-заголовков (headers) после того, как сценарий начал выводить HTML-текст. (В обычном случае невозможно послать заголовок после того, как был начат вывод текста.)
Эти функции не воздействуют на заголовки, посланные функциями header() или setcookie(), а только на функции, подобные echo() и HTML-тексту между блоками PHP-кода.
<?php
ob_start();
echo "Hellon"
setcookie("cookiename", "cookiedata");
ob_end_flush();
?>
В примере выше вывод командой echo() будет сохранен в буфере вывода до вызова функции ob_end_flush(). В то же время вызов setcookie() успешно сохраняет cookie, не вызывая ошибки.
Введение
Данная группа функций позволяет управлять тем, как PHP при выполнении сценария выводит информацию. Это может быть полезно в различных ситуациях, в особенности при посылке браузеру HTML-заголовков (headers) после того, как сценарий начал выводить HTML-текст. (В обычном случае невозможно послать заголовок после того, как был начат вывод текста.)
Эти функции не воздействуют на заголовки, посланные функциями header() или setcookie(), а только на функции, подобные echo() и HTML-тексту между блоками PHP-кода.
<?php
ob_start();
echo "Hellon"
setcookie("cookiename", "cookiedata");
ob_end_flush();
?>
В примере выше вывод командой echo() будет сохранен в буфере вывода до вызова функции ob_end_flush(). В то же время вызов setcookie() успешно сохраняет cookie, не вызывая ошибки.
Функции управления выводом
ob_start
Включение буферизации вывода.
Синтаксис:
void ob_start([string output_callback])
После вызова этой функции включается буферизация вывода и, пока она активна, никакие из выводящихся данных не будут посланы браузеру, а будут сохраняться во внутреннем буфере PHP.
Содержимое буфера может быть скопировано в строковую переменную функцией ob_get_contents(). Для вывода содержимого из буфера используется функция ob_end_flush(). Удалить содержимое буфера позволяет функция ob_end_clean().
В аргументе
Буферизация может быть вложенной, и тогда она обрабатывается соответственно вложенности; и содержимое, выводимое из буфера нижнего уровня, будет включаться в буфер верхнего уровня. Не забывайте, что для вывода всего буферизованного содержимого необходимо вызывать функцию ob_end_flush() столько же раз, сколько была вызвана ob_start().
<?php
function c($str) { // получает содержимое буфера
return nl2br($str); // возвращает содержимое буфера
}
function d($str) { // получает содержимое буфера
return strtoupper($str); // возвращает содержимое буфера
}
?>
<?php
ob_start("c");
?>
Тут различный текст...
<?php
// преобразовывать текст длее в верхний регистр
ob_start("d");
?>
еще что-то...
<?php
ob_end_flush();
?>
.......
<?php
ob_end_flush();
?>
ob_get_contents
Получение содержимого буфера вывода.
Синтаксис:
string ob_get_contents()
Если буферизация неактивна, возвращается false.
ob_get_length
Получение длины данных в буфере вывода.
Синтаксис:
string ob_get_length()
Если буферизация неактивна, возвращается false.
ob_end_flush
Вывод содержимого буфера.
Синтаксис:
void ob_end_flush(void)
После вывода буфер текущего уровня очищается, поэтому вызывайте функцию ob_get_contents() заранее, если необходимо получить его содержимое.
flush
Вывод всего содержимого буфера.
Синтаксис:
void flush(void);
Функция воздействует только на буферизацию PHP и не может контролировать схему буферизации web-сервера или браузера.
Некоторые серверы, в особенности под Win32, буферизуют выводящиеся сценарием данные до того, как сценарий завершится и данные будут отосланы браузеру.
Браузер, в свою очередь, также может буферизировать получаемые данные до их отображения. Netscape, например, буферизирует текст до получения символа завершения строки или открывающего тега, а для таблиц - до получения тега </table> таблицы верхнего уровня.
ob_end_clean
Очистка буфера.
Синтаксис:
void ob_end_clean(void);
Вызов функции отключает буферизацию на текущем уровне.
ob_implicit_flush
Установление режима буферизации.
Синтаксис:
void ob_implicit_flush([int flag]);
Если в аргументе указано ненулевое значение или оно не указано, то при осуществлении каждой операции вывода будет неявно вызываются функция flush().
Надо отметить, что часто эта функция работает курьезно; например, если в конце сценария вызвать функцию ob_end_clean(), то сценарий не выведет ничего, если вывод из буфера не производился явно другими функциями.
Управление исполнением сценария PHP
set_time_limit
Установка предельного времени исполнения сценария.
Синтаксис:
void set_time_limit(int seconds)
При запуске сценария PHP запускает системный таймер, и если время (выделенное сценарию для выполнения) истекает, а сценарий еще не завершился, PHP принудительно завершает сценарий (генерируя фатальную ошибку исполнения). Это не допускает скопления большого количества сценариев, расходующих ресурсы сервера, но, повидимому, "зависших" (например, если в них обнаружился бесконечный цикл или они пытаются дождаться подключения к не отвечающему серверу).
По умолчанию допустимое время исполнения сценария устанавливается в файле конфигурации параметром
Отсчет времени начинается от момента вызова функции. Например, если сценарий уже выполнялся в течении 15 секунд, а затем вызывается функция set_time_limit(20), то общее максимальное время исполнения сценария становится равным 35 секундам.
Если сценарий выполняется в безопасном режиме (с установленным параметром
sleep
Задержка выполнения сценария.
Синтаксис:
void sleep(int seconds);
Фукция sleep() выполняет задержку выполнения сценария в секундах (
usleep
Задержка выполнения сценария в микросекундах.
Синтаксис:
void usleep(int micro_seconds);
Задержка выполнения сценария в микросекундах (
Эта функция не работает в Windows.
die
Вывод сообщения и завершение текущего сценария.
Синтаксис:
void die(string message);
Эта функция выводит сообщение и прекращает выполнение текущего скрипта. Не возвращает значение.
<?php
$filename = '/path/to/data-file';
$file = fopen($filename, 'r')
or die "unable to open file ($filename)";
?>
exit
Завершает текущий сценарий.
Синтаксис:
void exit(void);
Эта функция завершает текущий сценарий. Не возвращает значение.
assert
Проверка истинности значения.
Синтаксис:
int assert(string|bool assertion);
В качестве аргумента функции может быть указано значение или строка, содержащая код PHP (как в функции eval()). Функция проверяет, является ли значение (или выражение) равным false, и, если это так, выполняет определенные действия.
Поведение функции определяется установками в файле конфигурации или при вызове функции assert_options().
Обычно эта функция используется исключительно в целях отладки, для проверки тех значений, которые всегда должны быть истинны (например: подключение модуля, свободное пространство на диске и т.д.).
В целом же выполнение сценария не должно зависеть от таких проверок, а использовать обычные проверки возвращаемых функциями значений.
<?php
function handler() {
echo "n* Failed * n";
}
assert("$a='1';");
echo "a: $a n";
assert(0);
// завершать сценарий
echo assert_options(ASSERT_BAIL, 1);
// вызвать обработчик
assert_options(ASSERT_CALLBACK, "handler");
// не выдавать сообщений PHP
@assert(--$a);
// эта строка не будет выполнена
echo "n ... n";
?>
Приведенный пример выведет:
a: 1Warning: Assertion failed in file.php on line 200* Failed *
assert_options
Определение параметров assert.
Синтаксис:
mixed assert_options(int parameter [, mixed value])
Эта функция позволяет определить поведение конструкции assert().
Возвращается предыдущее значение параметра (или значение false при ошибке), указанного в первом аргументе одной из следующих констант:
Если значение необходимо переопределить, его указывают во втором аргументе.
eval
Производит выполнение строки содержащей PHP код.
Синтаксис:
void eval(string code_str);
Функция eval() производит выполнение строки, заданной в
При изменении переменных значений в eval() эти переменные будут изменены и в основных данных.
Если в строке указан оператор return, то тогда выполнение указанного кода будет досрочно завершено и возвращенное значение можно будет получить как значение, возвращаемое самой функции.
<?php
$string = 'cup';
$name = 'coffee';
$str = 'This is a $string with my $name in it.
';
echo $str;
eval( "$str = "$str";" );
echo $str;
?>
Результатом выполнения этого кода будет:
This is a $string with my $name in it.This is a cup with my coffee in it.
Функции управления сценарием
set_time_limit
Установка предельного времени исполнения сценария.
Синтаксис:
void set_time_limit(int seconds)
При запуске сценария PHP запускает системный таймер, и если время (выделенное сценарию для выполнения) истекает, а сценарий еще не завершился, PHP принудительно завершает сценарий (генерируя фатальную ошибку исполнения). Это не допускает скопления большого количества сценариев, расходующих ресурсы сервера, но, повидимому, "зависших" (например, если в них обнаружился бесконечный цикл или они пытаются дождаться подключения к не отвечающему серверу).
По умолчанию допустимое время исполнения сценария устанавливается в файле конфигурации параметром
Отсчет времени начинается от момента вызова функции. Например, если сценарий уже выполнялся в течении 15 секунд, а затем вызывается функция set_time_limit(20), то общее максимальное время исполнения сценария становится равным 35 секундам.
Если сценарий выполняется в безопасном режиме (с установленным параметром
sleep
Задержка выполнения сценария.
Синтаксис:
void sleep(int seconds);
Фукция sleep() выполняет задержку выполнения сценария в секундах (
usleep
Задержка выполнения сценария в микросекундах.
Синтаксис:
void usleep(int micro_seconds);
Задержка выполнения сценария в микросекундах (
Эта функция не работает в Windows.
die
Вывод сообщения и завершение текущего сценария.
Синтаксис:
void die(string message);
Эта функция выводит сообщение и прекращает выполнение текущего скрипта. Не возвращает значение.
<?php
$filename = '/path/to/data-file';
$file = fopen($filename, 'r')
or die "unable to open file ($filename)";
?>
exit
Завершает текущий сценарий.
Синтаксис:
void exit(void);
Эта функция завершает текущий сценарий. Не возвращает значение.
assert
Проверка истинности значения.
Синтаксис:
int assert(string|bool assertion);
В качестве аргумента функции может быть указано значение или строка, содержащая код PHP (как в функции eval()). Функция проверяет, является ли значение (или выражение) равным false, и, если это так, выполняет определенные действия.
Поведение функции определяется установками в файле конфигурации или при вызове функции assert_options().
Обычно эта функция используется исключительно в целях отладки, для проверки тех значений, которые всегда должны быть истинны (например: подключение модуля, свободное пространство на диске и т.д.).
В целом же выполнение сценария не должно зависеть от таких проверок, а использовать обычные проверки возвращаемых функциями значений.
<?php
function handler() {
echo "n* Failed * n";
}
assert("$a='1';");
echo "a: $a n";
assert(0);
// завершать сценарий
echo assert_options(ASSERT_BAIL, 1);
// вызвать обработчик
assert_options(ASSERT_CALLBACK, "handler");
// не выдавать сообщений PHP
@assert(--$a);
// эта строка не будет выполнена
echo "n ... n";
?>
Приведенный пример выведет:
a: 1Warning: Assertion failed in file.php on line 200* Failed *
assert_options
Определение параметров assert.
Синтаксис:
mixed assert_options(int parameter [, mixed value])
Эта функция позволяет определить поведение конструкции assert().
Возвращается предыдущее значение параметра (или значение false при ошибке), указанного в первом аргументе одной из следующих констант:
Если значение необходимо переопределить, его указывают во втором аргументе.
eval
Производит выполнение строки содержащей PHP код.
Синтаксис:
void eval(string code_str);
Функция eval() производит выполнение строки, заданной в
При изменении переменных значений в eval() эти переменные будут изменены и в основных данных.
Если в строке указан оператор return, то тогда выполнение указанного кода будет досрочно завершено и возвращенное значение можно будет получить как значение, возвращаемое самой функции.
<?php
$string = 'cup';
$name = 'coffee';
$str = 'This is a $string with my $name in it.
';
echo $str;
eval( "$str = "$str";" );
echo $str;
?>
Результатом выполнения этого кода будет:
This is a $string with my $name in it.This is a cup with my coffee in it.
Статус подключений
Внутренне PHP имеет три статуса подключения:
При нормальном выполнении сценария активно состояние NORMAL. Если во время загрузки страницы пользователь нажал кнопку STOP, активным становится состояние ABORTED. Если сценарий выполняется дольше отведенного ему времени, устанавливается флаг состояния TIMEOUT. Возможно определить, как должен вести себя сценарий в зависимости от этих условий.
Если требуется, чтобы сценарий продолжал свое выполнение при разрыве соединения пользователем, нужно установить в файле конфигурации значение параметра
Чтобы игнорировать завершение сценария таймером, необходимо использовать функцию set_time_limit().
Если функцией register_shutdown_function() была установлена функция "запускаемая при завершении сценария", то, вне зависимости от статуса подключения, она будет исполнена перед тем, как сценарий завершится. И в "завершающей" функции можно будет выяснить (с помощью функции: connection_aborted(), connection_timeout() и connection_status()), был ли сценарий завершен нормально или досрочно.
connection_aborted
Определения разрыва подключения пользователем.
Синтаксис:
int connection_aborted(void);
Функция connection_aborted() возвращает true, если подключение было разорвано пользователем.
connection_status
Определения статуса подключения.
Синтаксис:
int connection_status(void);
Возвращает значение битового поля, позволяющее выяснить в "завершающей" функции, был ли сценарий завершен досрочно и причину этого. Например, если возвращается 3 (ABORTED | TIMEOUT), то это означает, что время выполнения истекло, а также то, что пользователь отказался от загрузки страницы.
Если возвращается 0 (то есть значение NORMAL), то это означает, что выполнение сценария не было прервано.
connection_timeout
Определения наступления тайм-аута.
Синтаксис:
int connection_timeout(void);
Возвращает true, если время выполнения сценария истекло.
ignore_user_abort
Прерывание сценария при разрыве подключения.
Синтаксис:
int ignore_user_abort([int setting]);
Аргументом
register_shutdown_function
Устанавливает функцию, которая будет выполнена при завершении.
Синтаксис:
int register_shutdown_function(string func);
Регистрирует функцию с именем
Заметьте: так как после завершения функции никакие средства вывода недоступны, это делает для функции, зарегистрированной в качестве "завершающей", недоступными обычные средства отладки, такие команды как print или echo.
Дополнительные функции
get_browser
Определение возможностей браузера.
Синтаксис:
object get_browser([string user_agent]);
Возвращаемая информация извлекается из файла
Информация возвращается в виде свойств объекта и отражает возможности клиентского браузера (например, версию, поддерживает ли он javascript или cookies).
<?php
function list_array($array) {
while (list ($key, $val) == each ($array)) {
$str .= "<b>$key:</b> $val<br>n";
}
return $str;
}
echo "$HTTP_USER_AGENT<hr>";
$bouser = get_browser();
echo list_array ((array) $browser);
?>
Содержимое возможного вывода:
Mozilla/4.5 [en] (X11: Linux 2.2.9 i586)<hr><b>browser_name_pattern:</b>Mozilla/4.5.*<br><b>parent:</b>Netscape<br><b>platform:</b>Unknown<br><b>majorver:</b>4<br><b>minorver:</b>5<br><b>browser:</b>Netscape<br><b>version:</b>4<br><b>frames:</b>1<br><b>tables:</b>1<br><b>cookies:</b>1<br><b>backgroundsounds:</b> <br><b>vbscript:</b> <br><b>javascript:</b>1<br><b>javaapplets:</b>1<br><b>activexcontrols:</b> <br><b>beta:</b> <br><b>crawler:</b> <br><b>authenticodeupdate:</b> <br><b>msn:</b> <br>
Для того чтобы функция могла функционировать, следует правильно указать месторасположение файла
highlight_file
Вывод содержимого файла с цветовой разметкой.
Синтаксис:
boolean highlight_file(string filename);
Имя или путь файла указывается в аргументе. Цвета выделения синтаксиса определяются в файле конфигурации PHP. Возвращает true или false при ошибке.
Например, чтобы заставить сервер Apache при получении запроса с URL, содержащего значение вида "
# Используем директиву "ForceType" чтобы указать,# что значение source в URL - не каталог, а имя сценария PHP<Location /source> ForceType application/x-httpd-php</Location>
Создайте в корневом web-каталоге следующий файл с именем source:
<HTML><HEAD>
<TITLE>Source Display</TITLE>
</HEAD>
<BODY bgcolor=#FFEEDD>
<?php
$script = getenv ("PATH_TRANSLATED");
if(!$script) {
echo "<BR><B>ERROR: Укажите имя сценария</B><BR>";
} else {
if(ereg("(.php|.inc)$",$script)) {
echo "<H!>Листинг файла: $PATH_INFO</H1>n<hr>n";
if(!@highlight_file($script))
echo "Ошибка вывода файла";
} else {
echo "<H1>ERROR: Показываются только листинги PHP файлов </H1>";
}
}
echo "<HR>Распечатано: ".date("Y/M/d H:i:s",time());
?>
</BODY>
</HTML>
highlight_string
Выделение строки цветом.
Синтаксис:
void highlight_string(string str);
Функция действует подобно highlight_file(), но использует не содержимое файла, а указанной строки.
show_source
Синоним функции highlight_file.
Синтаксис:
boolean show_source(string str);
pack
Пакетирование данных в двоичную строку.
Синтаксис:
string pack(string format [,mixed $args, ...]);
Функция pack() упаковывает заданные аргументы в бинарную строку, которая затем и возвращается. Формат параметров, а также их количество, задается при помощи строки
Вот полный список спецификаторов формата:
// Целое, целое, все остальное - сиволы
$bindata = pack("nvc*", 0x1234, 0x5678, 65, 66);
После выполнения приведенного кода в строке
unpack
Распаковывает данные из двоичной строки.
Синтаксис:
array unpack(string format, string data);
Распаковывает данные из двоичной строки в массив согласно формату. Возвращает массив, содержащий распакованные элементы.
$array = unpack("c2chars/nint", $binarydata);
Возникающий в результате массив будет содержать "chars1", "chars2" и "int".
iptcparse
Анализирует двоичный IPTC блок на одиночные тэги.
Синтаксис:
array iptcparse(string iptcblock);
Эта функция анализирует двоичный блок IPTC на одиночные теги. Возвращает массив, использующий
leak
Имитация утечки памяти.
Синтаксис:
void leak(int bytes);
leak() отсекает определенный объем памяти.
Это полезно при отладке диспетчера памяти, который автоматически очищает "отсеченную" память при выполнении запроса.
Размер блока памяти указывается в байтах аргументом
serialize
Генерирует удобохраниемое представление значения.
Синтаксис:
string serialize(mixed value);
serialize() возвращает строку состоящую из потока байтов при представлении значения
Это полезно для сохранения или передачи значений PHP без потери их типа и структуры.
Пример:
//$session_data содержит многомерный массив
с информацией о сессии
//текущего пользователя. Мы используем
serialize() для сохранения
//этого в базе данных в конце запроса.
$conn = odbc_connect("webdb", "php", "chicken");
$stmt = odbc_prepare($conn,
"UPDATE sessions SET data = ? WHERE id = ?");
$sqldata = array(serialize($session_data),
$PHP_AUTH_USER);
if (!odbc_execute($stmt, &$sqldata)) {
$stmt = odbc_prepare($conn,
INSERT INTO sessions (id, data) VALUES(?, ?)");
if (!odbc_execute($stmt, &$sqldata)) {
/* Что-то сделано неправильно. */
}
}
unserialize
Создает PHP значение из сохраненного представления.
Синтаксис:
mixed unserialize(string str);
unserialize() берет одно сохраненное значение и преобразует обратно в PHP значение. Возвращает преобразованное значение, и может иметь тип: integer, double, string, array или object. Если был преобразован object, то методы не востановятся.
Пример:
// Здесь мы используем unserialize() для загрузки
данных о сессии из базы данных
// в $session_data. Этот пример дополняет
описанный в месте
// с serialize() .
$conn = odbc_connect("webdb", "php", "chicken");
$stmt = odbc_prepare($conn,
"SELECT data FROM sessions WHERE id = ?");
$sqldata = array($PHP_AUTH_USER);
if (!odbc_execute($stmt, &$sqldata) ||
!odbc_fetch_into($stmt, &$tmp)) {
// Если сбой запуска или выборки ,
// то инициализируем массив
$session_data = array();
} else {
// Мы должны иметь представление в $tmp[0].
$session_data = unserialize($tmp[0]);
if (!is_array($session_data)) {
// Что-то неправильно, инициализируем массив
$session_data = array();
}
}
uniqid
Генерирует уникальный идентификатор.
Синтаксис:
int uniqid(string prefix [, boolean lcg]);
Функция uniqid() возвращает уникальный идентификатор, основанный на текущем времени в микросекундах и имеющий префикс prefix.Префикс может быть полезен, например, если Вы генерируете идентификаторы одновременно на отдельных хостах, которые, могли бы случилось, генерировали идентификатор в одной и той же микросекунде. Префикс может быть длиной до 114 символов.Если в качестве его значения передается пустая строка, то длина сгенерированного идентификатора будет 13 символов (при lcg=true - 23 символа).
Если указан необязательный аргумент lcg со значением true, к концу идентификатора будет добавляться "комбинированный хеш энтропии LCG", делающий его значение более уникальным.
Принято также дообрабатывать полученное значение криптографическими методами (например, это часто делается в идентификаторах сессий).
// без случайной части
$token = md5(uniqid(""));
// посложнее
$better_token = md5(uniqid(rnad()));
Эти строки генерируют 32 байта (128-битное шестнадцатеричное число): они обладают максимальной унакальностью, которая только может потребоваться.
Почтовые функции
Отсылает почту.
Синтаксис:
mail($to, $subject, $msg [,$headers]);
Функция mail() посылает сообщение с телом
Пример:
mail("info@spravkaweb.ru admin@spravkaweb.ru",
"Мое сообщение",
"Первая строка\nВторая строка\nТретья строка"
);
В случае, если указан четвертый параметр, переданная в нем строка вставляется между концом стандартных почтовых заголовков (таких как To, Content-type и т.д.) и началом текста письма. Обычно этот параметр используется для задания дополнительных заголовков письма.
Пример:
mail("info@spravkaweb.ru admin@spravkaweb.ru",
"Тема",
"Тело письма",
"From: webmaster@chat.run".
"Reply-To: webmaster@chat.run".
"X-Mailer: PHP/" . phpvarsion()
);
Функции запуска программ
escapeshellcmd
Убирает shell метасимволы.
Синтаксис:
string escapeshellcmd(string command);
Убирает любые символы в строке, которые могут быть использованы в командном интерпретаторе как произвольные команды. Эту функцию нужно использовать, что бы убедится, что все ваши данные введены правильно, и эту функцию лучше всего вставлять в функции exec() или system().
Стандартное использование этой функции выглядит так:
system(EscapeShellCmd($cmd))
exec
Запуск внешней программы.
Синтаксис:
string exec(string command [, string array [, int return_var]]);
Функция exec() скрыто от пользователя запускает программу из строки
Если параметр
Если параметр
<?php
$se = "dir c:\";
$s0 = exec($se, $sa, $sr);
echo "При запуске команды "$se" последняя выведенная строка была:n",
$s0,"n Код возврата ($sr) nА это все что было выведено: ";
print_r($sa);
?>
Если требуется запустить программу в фоновом режиме (на длительное время), то поток ее вывода должен быть перенаправлен в файл (или иной поток вывода); иначе по истечении допустимого времени исполнения сценария (ожидания завершения внешней программы) он будет принудительно завершен с ошибкой.
system
Запуск внешней программы с выводом результата.
Синтаксис:
string system(string command, int [return_var]);
это функция для запуска
Вызов System() также пробует автоматически вставить в буфер вывода web сервера после каждой строки вывода, если PHP запущен как модуль сервера.
passthru
Запускает внешнюю программу и выводит данные напрямую.
Синтаксис:
string passthru(string command [, int return_var]);
Функция passthru() похожа на функцию exec() для запуска
Функции динамической загрузки
dl
Загрузка библиотеки расширения PHP во время выполнения.
Синтаксис:
int dl(string library);
dl("extensions/php_db.dll");
Загружает PHP расширение определенное в
get_loaded_extensions
Определения перечня загруженных модулей.
Синтаксис:
array get_loaded_extensions(void);
Возвращает массив, содержащий список имен модулей PHP, которые были скомпилированны, загружены при старте PHP и загружены во время исполнения функцией dl().
print_r (get_loaded_extensions());
Выводит информацию, подобную следующей:
Array( [0] => standard [1] => bcmath [2] => calendar [3] => ctype [4] => com [5] => ftp [6] => mysql [7] => odbc [8] => overload [9] => pcre [10] => session [11] => tokenizer [12] => xml [13] => wddx [14] => zlib [15] => exif [16] => gd [17] => zip)
extension_loaded
Проверка загрузки модуля.
Синтаксис:
bool extension_loaded(string name);
Возвращает true, если указанный модуль
get_extension_funcs
Определение функций модуля.
Синтаксис:
array get_extension_funcs(string module_name);
Возвращает массив, содержащий перечисление имен функций, содержащихся в модуле
print_r(get_extension_funcs("xml"));
Информационные функции
phpinfo
Выводит текущее состояние всех параметров PHP.
Синтаксис:
int phpinfo([int what])
Для сокращения объема выводимой информации можно указать один из следующих разделов
Эта функция,которая в общем-то не должна появляться в законченной программе, выводит в броузер большое количество различной информации, касающейся настроек PHP и параметров вызова сценария. Именно, в стандартный выходной поток (то есть в браузер пользователя) печатается:
Функция phpinfo() в основном применяется при первоначальной установке PHP для проверки его работоспособности (уж больно много она выдает информации).
phpversion
Возвращает текущую версию PHP.
Синтаксис:
string phpversion();
Возвращает строку, содержащую название версии интерпретатора PHP.
echo phpversion();
phpcredits
HTML-распечатка разработчиков PHP.
Синтаксис:
void phpcredits(inf flag);
Выводит информацию о создателях и их вкладе в разработку пакета PHP.
phpcredits(CREDITS_GENERAL);
Флаги можно комбинировать следующим образом:
phpcredits(CREDITS_GROUP + CREDITS_DOCS + CREDITS_FULLPAGE);
Далее приведу список доступных флагов:
php_sapi_name
Получение типа интерфейса между Web-сервером и PHP.
Синтаксис:
string php_sapi_name();
Возвращает строку, содержащую строчными буквами тип интерфейса. Для CGI PHP, это будет строка "
$sapi_type = php_sapi_name();
if($sapi_type == "cgi")
echo "Это CGI PHPn";
else
echo "Это не CGI PHP а $sapi_type";
php_uname
Определение операционной системы.
Синтаксис:
string php_uname();
Возвращает строку, содержащую название операционной системы, например
if(substr(php_uname(),0,7) != "Windows") {
die("Этот сценарий должен выполняться в Windows.");
}
ini_set
Изменение параметра конфигурации.
Синтаксис:
string ini_set(string varname, string newvalue);
Устанавливает для указанного параметра
ini_alter
Тоже, что и ini_set().
Синтаксис:
string ini_alter(string varname, string newvalue);
ini_get
Эта функция получает значения параметров конфигурации.
Синтаксис:
string ini_get(string varname);
Возвращает текущее значение параметра конфигурации, заданное в переменной
Данная функция позволяет получить все доступные в PHP параметры.
В случае ошибки возвращает false.
ini_restore
Производит восстановление параметра конфигурации.
Синтаксис:
string ini_restore(string varname);
Устанавливает значение параметра конфигурации
echo ini_set("precision",20).ini_get("precision").
ini_restore("precision").ini_get("precision");
// Выведет 14 20 14
get_cfg_var
Получает значения параметра непосредственно из файла php.ini.
Синтаксис:
string get_cfg_var(string varname);
Надо отметить, что в отличии от функции ini_get(), которая возвращает текущее значение параметра, функция get_cfg_var() возвращает значение параметра, которое установлено в файле конфигурации php.ini. Также эта функция не возвращает другие параметры (например, из конфигурации самого сервера).
getenv
Функция возвращает значение переменной окружения.
Синтаксис:
string getenv(string varname);
$ip = getenv("REMOTE_ADDR");
echo "Ваш IP-адрес: $ip";
Список переменных окружения можно посмотреть в Приложения-Переменные окружения, или при помощи функции phpinfo().
Эта функция не работает в модуле PHP ISAPI.
putenv
Устанавливает переменную окружения.
Синтаксис:
void putenv(string setting);
putenv("UNIQID=$uniquid");
get_magic_quotes_gpc
Получает текущее значение параметра
Синтаксис:
long get_magic_quotes_gpc();
Эта функция возвратит 0 для
get_magic_quotes_runtime
Предназначена для получения текущего значения параметра
Синтаксис:
long get_magic_quotes_runtime();
Эта функция возвратит 0 для
set_magic_quotes_runtime
Предназначена для установки текущего значения параметра
Синтаксис:
long set_magic_quotes_runtime(int new_setting);
Для установки
php_logo_guid
Функция получения GUID логотипа PHP.
Синтаксис:
string php_logo_guid();
Строка
echo php_logo_guid();
возвратит
PHPE9568F34-D428-11d2-A769-00AA001ACF42
zend_logo_guid
Функция получения GUID логотипа Zend.
Синтаксис:
string zend_logo_guid();
Строка
echo zend_logo_guid();
возвратит
PHPE9568F35-D428-11d2-A769-00AA001ACF42
Взаимодействие с базами данных
База данных MySQL
mysql_connect
Устанавливает сетевое соединение с базой данных MySQL.
Синтаксис:
int mysql_connect([string $hostname[:port][:/path/to/socket][, [,string $username [,string $password]]])
Функция mysql_connect() устанавливает сетевое соединение с базой данных MySQL, расположенной на хосте
При ошибке выдается предупреждение. Выдачу сообщения об ошибке можно блокировать, указав перед именем функции оператор "@".
При следующем запуске функции с теми же самыми аргументами второе соединение не будет открыто, а функция возвратит идентификатор уже существующего.
В конце сценария обычно принято закрывать подключения функцией mysql_close(), но этого можно не делать, т.к. PHP автоматически закрывает все (неустойчивые) подключения при завершении сценария.
<?php
$conn = mysql_connect ("localhost", "username", "pass")
or die ("Соединение не установлено!");
print ("Соединение установлено!");
mysql_close($conn);
?>
mysql_pconnect
Устанавливает устойчивое сетевое соединение с базой данных MySQL.
Синтаксис:
int mysql_pconnect([string $hostname[:port][:/path/to/socket][, [,string $username [,string $password]]])
Функция mysql_pconnect() устанавливает устойчивое сетевое соединение с базой данных MySQL, расположенной на хосте
При ошибке выдается предупреждение. Выдачу сообщения об ошибке можно блокировать, указав перед именем функции оператор "@".
При следующем запуске функции с теми же самыми аргументами второе соединение не будет открыто, а функция возвратит идентификатор уже существующего.
mysql_pconnect() действует аналогично mysql_connect(), но с двумя отличиями:
mysql_close
Закрывает установленное ранее соединение с базой данных.
Синтаксис:
int mysql_close ([int link_identifier])
Закрывает соединение с MySQL-сервером с идентификатором
Возвращает true при удачном закрытии или false при ошибке.
Использование этой функции не обязательно, т.к. PHP автоматически закрывает все неустойчивые подключения при завершении работы сценария.
Подключения, установленные функцией mysql_pconnect(), не закрываются.
<?php
$conn = mysql_connect ("localhost", "username", "pass")
or die ("Соединение не установлено!");
print ("Соединение установлено!");
mysql_close($conn);
?>
mysql_change_user
Изменяет параметры подключения.
Синтаксис:
int mysql_change_user(string user, string password [, string database [, int link_identifier]])
Если не указывается БД или подключение, то используется последняя активная БД.
Если авторизация не произошла, то параметры подключения не изменяются.
Работает с MySQL 3.23.3 и выше.
mysql_list_dbs
Возвращает список БД на сервере.
Синтаксис:
int mysql_list_dbs([int link_identifier])
Возвращает набор записей, содержащий список БД на сервере.
$bd=mysql_connect("localhost", "name", "pass");
$bd_list=mysql_list_dbs($bd);
while($row=mysql_fetch_object($bd_list)) {
echo $row->Database."n";
}
Надо отметить, что список баз данных можно получить не имея привелегий, т.е. не указывая пароль доступа.
mysql_db_name
Возвращает имя базы данных из списка.
Синтаксис:
int mysql_db_name(int result, int row [, mixed field])
Параметр
В случае ошибки данная функция возвращает false.
mysql_connect("localhost", "username", "pass");
$db_list=mysql_list();
for($i=0;$i<($cnt=mysql_num_rows($db_list));$i++) {
echo mysql_db_name($db_list,$i)."n";
}
Ранее функция называлась mysql_dbname().
mysql_select_db
Выбор одной базы данных MySQL.
Синтаксис:
int mysql_select_db (string database_name [, int link_identifier])
Возвращает true при удачном закрытии или false при ошибке.
Если Вы планируете открывать только одно соединение с базой данных за все время работы сценария, то можете не сохранять возвращенное значение, а также не указывать идентификатор при вызове всех остальных функций.
До того как послать первый запрос серверу MySQL, необходимо указать, с какой базой данных мы собираемся работать. Для этого и предназначена данная функция. Она уведомляет, что в дальнейших операциях с соединением
Если на момент вызова данной функции подключений к базе данных нет, то косвенно вызывается функция mysql_connect() с параметрами по умолчанию.
mysql_create_db
Создание базы данных MySQL.
Синтаксис:
int mysql_create_db(string dbname [, int link_identifier])
Эта функция создает новую базу данных MySQL с именем
$db=mysql_connect("localhost", "name", "pass");
if(mysql_create_db("my_db_name")) {
echo "БД my_db_name создана");
} else {
echo "Ошибка создания БД: %sn".mysql_error());
}
mysql_drop_db
Удаление базы данных MySQL.
Синтаксис:
int mysql_drop_db(string database_name [, int link_identifier])
Функция mysql_drop_db() удаляет базу данных
В случае успешного удаления возвращает true, при ошибке - false.
mysql_list_tables
Возвращает список таблиц в БД.
Синтаксис:
int mysql_list_tables(string database [,int link_identifier])
Функция возвращает идентификатор результата (одна колонка), в котором содержаться имена всех таблиц, присутствующих в базе данных. Для извлечения этих имен можно использовать функцию mysql_result() с номером колонки, равным 0, иди функцию mysql_tablename().
Следующий пример выведет все имена баз данных и таблиц, которые в них содержаться:
$db=mysql_connect("localhost", "user_name", "");
$db_list=mysql_list_dbs($db);
while($r_db=mysql_fetch_object($db_list)) {
echo $r_db->Database."n";
// распечатать список таблиц
$t_list=mysql_list_tables($r_db->Database);
for($i=0;$i<mysql_num_rows($t_list);$i++) {
echo " - ".mysql_tablename($t_list,$i)."n";
}
}
mysql_tablename
Возвращает имя таблицы в БД.
Синтаксис:
int mysql_tablename(int result, int i)
Функция возвращает имя таблицы с номером i из набора записей, полученных при помощи функции mysql_list_tables().
$db=mysql_connect("localhost", "user_name", "");
$result=mysql_list_tables("db_name");
$i=0;
while($i<mysql_num_rows($result)) {
$t_name[$i]=mysql_tablename($result, $i);
echo $t_name[$i]."<BR>";
$i++;
}
mysql_query
Посылает запрос базе данных MySQL.
Синтаксис:
int mysql_query(string query [,int link_identifier])
Эта функция посылает запрос query базе данных, связанной с идентификатором
SQL-выражение, указанное в параметре
Если выражение содержит ошибки, или его выполнение приводит к ошибкам, то функция mysql_query() возвращает false.
В результате успешно выполненного запроса возвращается набор записей, который можно обработать следующими функциями:
Чтобы узнать, сколько записей было найдено командой
Для того, чтобы узнать, сколько записей было изменено в результате выполнения запросов
После обработки результатов запроса он может быть удален функцией mysql_free_result(). Но в этом нет необходимости, т.к. результаты сами уничтожаются после завершения работы сценария.
mysql_db_query
Посылает запрос к указанной базе данных MySQL.
Синтаксис:
int mysql_db_query(string database, string query [,int link_identifier])
Эта функция эквивалентна следующей последовательности функций:
mysql_select_db(string database [, int link_identifier]);mysql_query(string query [, int link_identifier]);
mysql_num_rows
Возвращает количество строк в результате запроса.
Синтаксис:
int mysql_num_rows(int result)
Эта функция возвращает число записей, найденных в результате выполнения SQL-команды
<?php
$link = mysql_connect("localhost", "username", "password");
mysql_select_db("database", $link);
$result = mysql_query("SELECT * FROM table1", $link);
$num_rows = mysql_num_rows($result);
echo "Получено строк: $num_rowsn";
?>
mysql_affected_rows
Возвращает количество измененных записей в БД MySQL.
Синтаксис:
int mysql_affected_rows([int link_identifier]);
Функция mysql_affected_rows() возвращает количество записей, которые были изменены в базе данных в результате выполнения запросов
Если последним запросом была команда
mysql_insert_id
Получает вставленный идентификатор.
Синтаксис:
int mysql_insert_id([int $link_identifier])
Функция возвращает непосредственно перед ее вызовом сгенерированный идентификатор записи для автоинкрементного поля после выполнения команды insert. Вызывать ее разумно только сразу после выполнения инструкции
mysql_query("insert into Таблица(поле 1, поле 2) values("aa","bb")");
$id=mysql_insert_id();
Теперь к только что вставленной записи можно обратиться, используя идентификатор
$r=mysql_query("select * from Таблица where id=$id");
$Row=mysql_fetch_array($r);
mysql_data_seek
Устанавливает указатель текущей строки.
Синтаксис:
int mysql_data_seek(int result, int row_number)
Эта функция устанавливает указатель текущей строки в результате
Нумерация записей ведется с 0.
Возвращает false в случае ошибки или если строки кончились.
mysql_free_result
Уничтожает набор записей.
Синтаксис:
int mysql_free_result(int result)
Данная функция освобождает память, занимаемую набором записей
Эта функция необходима, когда нужно экономить память, т.к. PHP автоматически освобождает память при завершении сценария.
Работа с базами данных
mysql_connect
Устанавливает сетевое соединение с базой данных MySQL.
Синтаксис:
int mysql_connect([string $hostname[:port][:/path/to/socket][, [,string $username [,string $password]]])
Функция mysql_connect() устанавливает сетевое соединение с базой данных MySQL, расположенной на хосте
При ошибке выдается предупреждение. Выдачу сообщения об ошибке можно блокировать, указав перед именем функции оператор "@".
При следующем запуске функции с теми же самыми аргументами второе соединение не будет открыто, а функция возвратит идентификатор уже существующего.
В конце сценария обычно принято закрывать подключения функцией mysql_close(), но этого можно не делать, т.к. PHP автоматически закрывает все (неустойчивые) подключения при завершении сценария.
<?php
$conn = mysql_connect ("localhost", "username", "pass")
or die ("Соединение не установлено!");
print ("Соединение установлено!");
mysql_close($conn);
?>
mysql_pconnect
Устанавливает устойчивое сетевое соединение с базой данных MySQL.
Синтаксис:
int mysql_pconnect([string $hostname[:port][:/path/to/socket][, [,string $username [,string $password]]])
Функция mysql_pconnect() устанавливает устойчивое сетевое соединение с базой данных MySQL, расположенной на хосте
При ошибке выдается предупреждение. Выдачу сообщения об ошибке можно блокировать, указав перед именем функции оператор "@".
При следующем запуске функции с теми же самыми аргументами второе соединение не будет открыто, а функция возвратит идентификатор уже существующего.
mysql_pconnect() действует аналогично mysql_connect(), но с двумя отличиями:
mysql_close
Закрывает установленное ранее соединение с базой данных.
Синтаксис:
int mysql_close ([int link_identifier])
Закрывает соединение с MySQL-сервером с идентификатором
Возвращает true при удачном закрытии или false при ошибке.
Использование этой функции не обязательно, т.к. PHP автоматически закрывает все неустойчивые подключения при завершении работы сценария.
Подключения, установленные функцией mysql_pconnect(), не закрываются.
<?php
$conn = mysql_connect ("localhost", "username", "pass")
or die ("Соединение не установлено!");
print ("Соединение установлено!");
mysql_close($conn);
?>
mysql_change_user
Изменяет параметры подключения.
Синтаксис:
int mysql_change_user(string user, string password [, string database [, int link_identifier]])
Если не указывается БД или подключение, то используется последняя активная БД.
Если авторизация не произошла, то параметры подключения не изменяются.
Работает с MySQL 3.23.3 и выше.
mysql_list_dbs
Возвращает список БД на сервере.
Синтаксис:
int mysql_list_dbs([int link_identifier])
Возвращает набор записей, содержащий список БД на сервере.
$bd=mysql_connect("localhost", "name", "pass");
$bd_list=mysql_list_dbs($bd);
while($row=mysql_fetch_object($bd_list)) {
echo $row->Database."n";
}
Надо отметить, что список баз данных можно получить не имея привелегий, т.е. не указывая пароль доступа.
mysql_db_name
Возвращает имя базы данных из списка.
Синтаксис:
int mysql_db_name(int result, int row [, mixed field])
Параметр
В случае ошибки данная функция возвращает false.
mysql_connect("localhost", "username", "pass");
$db_list=mysql_list();
for($i=0;$i<($cnt=mysql_num_rows($db_list));$i++) {
echo mysql_db_name($db_list,$i)."n";
}
Ранее функция называлась mysql_dbname().
mysql_select_db
Выбор одной базы данных MySQL.
Синтаксис:
int mysql_select_db (string database_name [, int link_identifier])
Возвращает true при удачном закрытии или false при ошибке.
Если Вы планируете открывать только одно соединение с базой данных за все время работы сценария, то можете не сохранять возвращенное значение, а также не указывать идентификатор при вызове всех остальных функций.
До того как послать первый запрос серверу MySQL, необходимо указать, с какой базой данных мы собираемся работать. Для этого и предназначена данная функция. Она уведомляет, что в дальнейших операциях с соединением
Если на момент вызова данной функции подключений к базе данных нет, то косвенно вызывается функция mysql_connect() с параметрами по умолчанию.
mysql_create_db
Создание базы данных MySQL.
Синтаксис:
int mysql_create_db(string dbname [, int link_identifier])
Эта функция создает новую базу данных MySQL с именем
$db=mysql_connect("localhost", "name", "pass");
if(mysql_create_db("my_db_name")) {
echo "БД my_db_name создана");
} else {
echo "Ошибка создания БД: %sn".mysql_error());
}
mysql_drop_db
Удаление базы данных MySQL.
Синтаксис:
int mysql_drop_db(string database_name [, int link_identifier])
Функция mysql_drop_db() удаляет базу данных
В случае успешного удаления возвращает true, при ошибке - false.
mysql_list_tables
Возвращает список таблиц в БД.
Синтаксис:
int mysql_list_tables(string database [,int link_identifier])
Функция возвращает идентификатор результата (одна колонка), в котором содержаться имена всех таблиц, присутствующих в базе данных. Для извлечения этих имен можно использовать функцию mysql_result() с номером колонки, равным 0, иди функцию mysql_tablename().
Следующий пример выведет все имена баз данных и таблиц, которые в них содержаться:
$db=mysql_connect("localhost", "user_name", "");
$db_list=mysql_list_dbs($db);
while($r_db=mysql_fetch_object($db_list)) {
echo $r_db->Database."n";
// распечатать список таблиц
$t_list=mysql_list_tables($r_db->Database);
for($i=0;$i<mysql_num_rows($t_list);$i++) {
echo " - ".mysql_tablename($t_list,$i)."n";
}
}
mysql_tablename
Возвращает имя таблицы в БД.
Синтаксис:
int mysql_tablename(int result, int i)
Функция возвращает имя таблицы с номером i из набора записей, полученных при помощи функции mysql_list_tables().
$db=mysql_connect("localhost", "user_name", "");
$result=mysql_list_tables("db_name");
$i=0;
while($i<mysql_num_rows($result)) {
$t_name[$i]=mysql_tablename($result, $i);
echo $t_name[$i]."<BR>";
$i++;
}
mysql_query
Посылает запрос базе данных MySQL.
Синтаксис:
int mysql_query(string query [,int link_identifier])
Эта функция посылает запрос query базе данных, связанной с идентификатором
SQL-выражение, указанное в параметре
Если выражение содержит ошибки, или его выполнение приводит к ошибкам, то функция mysql_query() возвращает false.
В результате успешно выполненного запроса возвращается набор записей, который можно обработать следующими функциями:
Чтобы узнать, сколько записей было найдено командой
Для того, чтобы узнать, сколько записей было изменено в результате выполнения запросов
После обработки результатов запроса он может быть удален функцией mysql_free_result(). Но в этом нет необходимости, т.к. результаты сами уничтожаются после завершения работы сценария.
mysql_db_query
Посылает запрос к указанной базе данных MySQL.
Синтаксис:
int mysql_db_query(string database, string query [,int link_identifier])
Эта функция эквивалентна следующей последовательности функций:
mysql_select_db(string database [, int link_identifier]);mysql_query(string query [, int link_identifier]);
mysql_num_rows
Возвращает количество строк в результате запроса.
Синтаксис:
int mysql_num_rows(int result)
Эта функция возвращает число записей, найденных в результате выполнения SQL-команды
<?php
$link = mysql_connect("localhost", "username", "password");
mysql_select_db("database", $link);
$result = mysql_query("SELECT * FROM table1", $link);
$num_rows = mysql_num_rows($result);
echo "Получено строк: $num_rowsn";
?>
mysql_affected_rows
Возвращает количество измененных записей в БД MySQL.
Синтаксис:
int mysql_affected_rows([int link_identifier]);
Функция mysql_affected_rows() возвращает количество записей, которые были изменены в базе данных в результате выполнения запросов
Если последним запросом была команда
mysql_insert_id
Получает вставленный идентификатор.
Синтаксис:
int mysql_insert_id([int $link_identifier])
Функция возвращает непосредственно перед ее вызовом сгенерированный идентификатор записи для автоинкрементного поля после выполнения команды insert. Вызывать ее разумно только сразу после выполнения инструкции
mysql_query("insert into Таблица(поле 1, поле 2) values("aa","bb")");
$id=mysql_insert_id();
Теперь к только что вставленной записи можно обратиться, используя идентификатор
$r=mysql_query("select * from Таблица where id=$id");
$Row=mysql_fetch_array($r);
mysql_data_seek
Устанавливает указатель текущей строки.
Синтаксис:
int mysql_data_seek(int result, int row_number)
Эта функция устанавливает указатель текущей строки в результате
Нумерация записей ведется с 0.
Возвращает false в случае ошибки или если строки кончились.
mysql_free_result
Уничтожает набор записей.
Синтаксис:
int mysql_free_result(int result)
Данная функция освобождает память, занимаемую набором записей
Эта функция необходима, когда нужно экономить память, т.к. PHP автоматически освобождает память при завершении сценария.
Обработка результатов запроса
mysql_result
Получение определенного поля результата.
Синтаксис:
int mysql_result(int result, int row [, mixed field])
Функция возвращает значение поля
Функция универсальна: с ее помощью можно "обойти" весь результат по одной ячейке. И хотя это не возбраняется, но делать, однако, не рекомендуется, т.к. mysql_result() работает довольно медленно.
mysql_fetch_array
Извлекает из результата очередную запись и помещает ее в ассоциативный массив.
Синтаксис:
array mysql_fetch_array(int result [, int result_type])
Функция mysql_fetch_array() возвращает очередную строку результата в виде ассоциативного массива, где каждому полю сопоставлен элемент с ключом, совпадающим с именем поля. Дополнительно в массив записываются элементы с числовыми ключами и значениями, соответствующими величинам полей с этими индексами. В возвращаемом массиве они размещаются сразу за элементами с "обычными" ключами.
Параметр
Может возникнуть вопрос: зачем вообще нужны числовые индексы. Ответ прост: дело в том, что в результате выборки в действительности могут присутствовать поля (фактически, колонки) с одинаковыми именами, но, соответственно, с различными индексами. Это происходит тогда, когда выборка в
mysql_connect($host, $user, $pass);
$result=mysql_db_query("database", "select id, name from tabl");
while($row=mysql_fetch_array($result)) {
echo "id: ".$row["id"]."<BR>";
echo "id: ".$row[0]."<BR>";
echo "name: ".$row["name"]."<BR>";
echo "name: ".$row[1]."<BR>";
};
mysql_free_result($result);
mysql_fetch_row
Записывает запись в нумерованный массив.
Синтаксис:
array mysql_fetch_row(int result)
Функция возвращает массив-список со значениями полей очередной строки результата
Каждое поле записи сохраняется в нумерованном элементе массива. Нумерация начинается с 0.
$r=mysql_query("select * from OutTable where age<30");
while($Row=mysql_fetch_row($r)) {
// обрабатываем строку $Row
}
Как видим, цикл оборвется, как только строки закончатся, т.е. когда mysql_fetch_row() вернет false.
mysql_fetch_object
Получение записи в свойствах объекта.
Синтаксис:
object mysql_fetch_object(int result)
Функция возвращает объект, в свойствах которого находятся поля текущей записи. В случае, если записи кончились, возвращает false.
mysql_connect($host, $user, $pass);
$result=mysql_db_query("database", "select * from table");
while($rows=mysql_fetch_object($result)) {
echo $rows->id;
echo $rows->name;
};
mysql_fetch_lengths
Возвращает длину элемента записи.
Синтаксис:
array mysql_fetch_lengths(int result)
Функция mysql_fetch_lengths() возвращает длину значения, полученного при помощи функций mysql_fetch_row(), mysql_fetch_array() или mysql_fetch_object().
Например, в следующем примере:
$arr=mysql_fetch_row($result);
$len=mysql_fetch_lengths($result);
массив
mysql_fetch_field
Возвращает информацию о свойствах объекта и о поле записи.
Синтаксис:
object mysql_fetch_field(int result [, int field_offset])
В необязательном параметре
Возвращаемый объект имеет следующие свойства:
mysql_connect($host,$user,$pass);
$result=mysql_db_query("database", select * from table");
for($i=0;$i<mysql_num_fields($result);$i++) {
echo "Свойства поля $i:<BR>";
$param=mysql_fetch_field($result);
if(!$param) echo "Нет информации о свойствах!";
echo "<PRE>
name: $param->name
table: $param->table
max_length: $param->max_length
not_null: $param->not_null
primary_key: $param->primary_key
unique_key: $param->unique_key
multiple_key: $param->multiple_key
numeric: $param->numeric
blob: $param->blob
type: $param->type
unsigned: $param->unsigned
zerofill: $param->zerofill
</PRE>";
}
mysql_field_seek
Производит перемещение курсора к указанному полю.
Синтаксис:
int mysql_field_seek(int result, int field_offset)
Данная функция является излишней. Следующие фрагменты будут эквивалентны:
$param=mysql_fetch_field($result, field_offset);
и
mysql_field_seek($result, field_offset);
$param=mysql_fetch_field($result);
mysql_field_name
Возвращает имя поля.
Синтаксис:
string mysql_field_name(int result, int filed_index)
Функция mysql_field_name() возвращает имя поля, которое расположено в результате
$result=mysql_query("SELECT id, name from table");
echo mysql_field_name($result,1); // Выведет: name
mysql_field_table
Возвращает имя таблицы, из которой было извлечено поле.
Синтаксис:
string mysql_field_table(int result, int field_offset)
Возвращает имя таблицы, из которой было извлечено поле со смещением
mysql_field_len
Возвращает длину поля.
Синтаксис:
int mysql_field_len(int result, int filed_offset)
Функция возвращает длину поля в результате
mysql_field_type
Возвращает тип набора записей в результате.
Синтаксис:
string mysql_field_type(int result, int filed_offset)
Эта функция похожа на mysql_filed_name(), только возвращает не имя , а тип соответствующей колонки в результате. Им может быть, например,
mysql_connect($host,$user,$pass);
mysql_select_db("mydb");
$result=mysql_query("SELECT * FROM tabl");
$fields=mysql_num_fields($result);
$rows=mysql_num_rows($result);
$i=0;
$table=mysql_field_table($result,$i);
echo "Таблица "$table" имеет $fields полей и $rows записей<BR>";
echo "Структура таблицы:<BR>";
while($i<$fields) {
$type=mysql_field_type($result,$i);
$name=mysql_field_name($result,$i);
$len=mysql_field_len($result,$i);
$flags=mysql_field_flags($result,$i);
echo $type." ".$name." ".$len." ".$flags."<BR>";
$i++;
}
mysql_field_flags
Эта функция возвращает флаги, которые были использованы при создании указанного поля в таблице.
Синтаксис:
Возвращаемая строка представляет собой набор слов, разделенных пробелами, так что вы можете преобразовать ее в массив при помощи функции explode():
$Flags=explode(" ",mysql_field_flags($r,$field_offset));
Поля записей в MySQL могут иметь следующие свойства-флаги:
mysql_list_fields
Возвращает список полей таблицы.
Синтаксис:
int mysql_list_fields(string dbname, string tblname [,int link_identifier])
Функция mysql_list_fields() возвращает информацию об указанной таблице
$link=mysql_connect($host,$user,$pass);
$fields=mysql_list_fields("db1", "table", $link);
$colums=mysql_num_fields($fields); // число полей в таблице
// Далее распечатаем имена всех полей таблицы
for($i=0;$i<$colums;$i++) {
echo mysql_field_name($fields,$i)."<BR>";
}
mysql_num_fields
Эта функция возвращает число полей в одной строке результата, т.е. число колонок в результате.
Синтаксис:
int mysql_num_fields(int result)
В силу сказанного, функция позволяет определить горизонтальную размерность "двумерного массива результата".
mysql_errno
Возвращает номер последней ошибки.
Синтаксис:
int mysql_errno ([int link_identifier])
Данная функция возвращает номер последней зарегистрированной ошибки или 0, если ошибок нет.
Идентификатор
mysql_connect("dbname");
echo mysql_errno().": ".mysql_error()."<BR>";
mysql_error
Возвращает сообщение об ошибке.
Синтаксис:
string mysql_error ([int link_identifier])
Эта функция возвращает строку, содержащую текст сообщения об ошибке или пустую строку, если ошибок небыло.
mysql_connect("dbname");
echo mysql_errno().": ".mysql_error()."<BR>";
Графика
Работа с изображениями и библиотека GD
Применение и установка
Здесь мы рассмотрим идею создания рисунков сценарием "на лету". Это очень может пригодиться при создании сценариев-счетчиков, графиков, картинок-заголовков, да и многого другого.
Для деятельности такого рода существует специальная библиотека под названием GD. Она содержит в себе множество функций (такие как рисование линий, растяжение/сжатие изображения, заливка до границы, вывод текста и т.д.), которые могут использовать программы, поддерживающие работу с данной библиотекой.
Поддержка GD включается при компиляции и установке PHP. Возможно, некоторые хостинг-провайдеры ее не имеют.
Для подключения модуля на вашем локальном диске нужно открыть в Блокноте файл
Затем:1. Настройте следующий параметр:extension_dir=C:\Program Files\PHP4\extensions
Здесь мы уведомляем PHP, что модули он должен искать в каталоге C:\Program Files\PHP4\extensions.
2. Найдите закомментированную строку
и разкомментируйте ее, т.е. уберите ; в начале.
3. Сохраните изменения в файле
imageTypes
Определение графических форматов, поддерживаемых PHP.
Синтаксис:
int imageTypes(void)
Функция возвращает битовую маску графических форматов, которые поддерживает данная версия библиотеки GD:
<?php
if(imageTypes() && IMG_PNG) echo "формат PNG поддерживается";
?>
GetImageSize
Определение размеров рисунка.
Синтаксис:
array GetImageSize(string filename [,array imageinfo])
Эта функция предназначена для быстрого определения в сценарии размеров (в пикселях) и формата рисунка, имя файла которого передано ей в первом параметре. Она возвращает список из четырех элементов. Первый элемент (с ключем 0) хранит ширину картинки в пикселях, второй (с ключем 1) - его высоту. Ячейка массива с ключем 2 определяется форматом изображения: 1, если это GIF, 2 в случае JPG, 3 для PNG и 4 - SWF. Следующий элемент, имеющий ключ 3, будет содержать после вызова функции строку примерно следующего вида:
<?php
$size_img=GetImageSize("img/image.jpg");
echo "<IMG src='img/image.jpg' $size_img>";
?>
Если при обращении к функции был указан второй необязательный массив
<?php
$size_img=GetImageSize("img/image.jpg", &$info_arr);
if(isset($info_Arr["APP13"])) {
$iptc = iptcparse($info_arr["APP13"]);
var_dump($iptc);
};
?>
Данная функция не требует наличия библиотеки GD.
imageSX
Определение ширины рисунка.
Синтаксис:
int imageSX(int im)
Функция возвращает горизонтальный размер изображения, заданного своим идентификатором
imageSY
Определение высоты рисунка.
Синтаксис:
int imageSY(int im)
Функция возвращает вертикальный размер изображения, заданного своим идентификатором
read_exif_data
Чтение заголовков
Синтаксис:
array read_exif_data(string filename)
Параметр
Функция возвращает ассоциативный массив, в котором индексами являются имена заголовков
Заголовки
<?php
$exif = read_exif_data("img/file.jpg");
print_r($exif);
?>
Данный пример выведет что-то наподобие:
Array( [FileName] => file.jpg [FileDateTime] => 1064566998 [FileSize] => 31646 [CameraMake] => Eastman Kodak Company [CameraModel] => KODAK DC265 ZOOM DIGITAL CAMERA (V01.00) [DateTime] => 2002:08:31 02:12:45 [Height] => 454 [Width] => 620 [IsColor] => 1 [FlashUsed] => 0 [FocalLength] => 8.0mm [RawFocalLength] => 8 [ExposureTime] => 0.004 s (1/250) [RawExposureTime] => 0.0040000001899898 [ApertureFNumber] => f/ 9.5 [RawApertureFNumber] => 9.5100002288818 [FocusDistance] => 16.66m [RawFocusDistance] => 16.659999847412 [Orientation] => 1 [ExifVersion] => 0200)
Данная функция доступна, если подключена библиотека
Для этого необходимо либо снять комментарий со строки
Для работы этой функции библиотека GD не требуется.
imageInterlace
Установка черезстрочности.
Синтаксис:
int imageInterlace(int im [, int interlace])
Если в функции задан второй необязательный параметр
Функция возвращает текущую установку черезстрочности.
gd_info
Возвращает информацию о библиотеке
Синтаксис:
array gd_info(void)
Функция возвращает массив, содержащий версию и параметры установленной библиотеки GD.
<?php
$gd=gd_info();
echo "<pre>";
print_r($gd);
echo "</pre>";
?>
Приведенный пример выведет примерно следующее:
Array( [GD Version] => bundled (2.0.22 compatible) [FreeType Support] => 1 [FreeType Linkage] => with freetype [T1Lib Support] => [GIF Read Support] => 1 [GIF Create Support] => [JPG Support] => 1 [PNG Support] => 1 [WBMP Support] => 1 [XBM Support] => 1 [JIS-mapped Japanese Font Support] => )
image_type_to_mime_type
Возвращает Mime-Type типа изображения.
Синтаксис:
string image_type_to_mime_type( int imagetype)
Функция возвращает MIME-тип картинки, заданный константой в параметре
<?php
header("Content-type: " . image_type_to_mime_type(IMAGETYPE_PNG));
?>
Список констант и возвращаемых значений функции image_type_to_mime_type():
Данная функция не требует наличия библиотеки GD.
Параметры изображения
Применение и установка
Здесь мы рассмотрим идею создания рисунков сценарием "на лету". Это очень может пригодиться при создании сценариев-счетчиков, графиков, картинок-заголовков, да и многого другого.
Для деятельности такого рода существует специальная библиотека под названием GD. Она содержит в себе множество функций (такие как рисование линий, растяжение/сжатие изображения, заливка до границы, вывод текста и т.д.), которые могут использовать программы, поддерживающие работу с данной библиотекой.
Поддержка GD включается при компиляции и установке PHP. Возможно, некоторые хостинг-провайдеры ее не имеют.
Для подключения модуля на вашем локальном диске нужно открыть в Блокноте файл
Затем:1. Настройте следующий параметр:extension_dir=C:\Program Files\PHP4\extensions
Здесь мы уведомляем PHP, что модули он должен искать в каталоге C:\Program Files\PHP4\extensions.
2. Найдите закомментированную строку
и разкомментируйте ее, т.е. уберите ; в начале.
3. Сохраните изменения в файле
imageTypes
Определение графических форматов, поддерживаемых PHP.
Синтаксис:
int imageTypes(void)
Функция возвращает битовую маску графических форматов, которые поддерживает данная версия библиотеки GD:
<?php
if(imageTypes() && IMG_PNG) echo "формат PNG поддерживается";
?>
GetImageSize
Определение размеров рисунка.
Синтаксис:
array GetImageSize(string filename [,array imageinfo])
Эта функция предназначена для быстрого определения в сценарии размеров (в пикселях) и формата рисунка, имя файла которого передано ей в первом параметре. Она возвращает список из четырех элементов. Первый элемент (с ключем 0) хранит ширину картинки в пикселях, второй (с ключем 1) - его высоту. Ячейка массива с ключем 2 определяется форматом изображения: 1, если это GIF, 2 в случае JPG, 3 для PNG и 4 - SWF. Следующий элемент, имеющий ключ 3, будет содержать после вызова функции строку примерно следующего вида:
<?php
$size_img=GetImageSize("img/image.jpg");
echo "<IMG src='img/image.jpg' $size_img>";
?>
Если при обращении к функции был указан второй необязательный массив
<?php
$size_img=GetImageSize("img/image.jpg", &$info_arr);
if(isset($info_Arr["APP13"])) {
$iptc = iptcparse($info_arr["APP13"]);
var_dump($iptc);
};
?>
Данная функция не требует наличия библиотеки GD.
imageSX
Определение ширины рисунка.
Синтаксис:
int imageSX(int im)
Функция возвращает горизонтальный размер изображения, заданного своим идентификатором
imageSY
Определение высоты рисунка.
Синтаксис:
int imageSY(int im)
Функция возвращает вертикальный размер изображения, заданного своим идентификатором
read_exif_data
Чтение заголовков
Синтаксис:
array read_exif_data(string filename)
Параметр
Функция возвращает ассоциативный массив, в котором индексами являются имена заголовков
Заголовки
<?php
$exif = read_exif_data("img/file.jpg");
print_r($exif);
?>
Данный пример выведет что-то наподобие:
Array( [FileName] => file.jpg [FileDateTime] => 1064566998 [FileSize] => 31646 [CameraMake] => Eastman Kodak Company [CameraModel] => KODAK DC265 ZOOM DIGITAL CAMERA (V01.00) [DateTime] => 2002:08:31 02:12:45 [Height] => 454 [Width] => 620 [IsColor] => 1 [FlashUsed] => 0 [FocalLength] => 8.0mm [RawFocalLength] => 8 [ExposureTime] => 0.004 s (1/250) [RawExposureTime] => 0.0040000001899898 [ApertureFNumber] => f/ 9.5 [RawApertureFNumber] => 9.5100002288818 [FocusDistance] => 16.66m [RawFocusDistance] => 16.659999847412 [Orientation] => 1 [ExifVersion] => 0200)
Данная функция доступна, если подключена библиотека
Для этого необходимо либо снять комментарий со строки
Для работы этой функции библиотека GD не требуется.
imageInterlace
Установка черезстрочности.
Синтаксис:
int imageInterlace(int im [, int interlace])
Если в функции задан второй необязательный параметр
Функция возвращает текущую установку черезстрочности.
gd_info
Возвращает информацию о библиотеке
Синтаксис:
array gd_info(void)
Функция возвращает массив, содержащий версию и параметры установленной библиотеки GD.
<?php
$gd=gd_info();
echo "<pre>";
print_r($gd);
echo "</pre>";
?>
Приведенный пример выведет примерно следующее:
Array( [GD Version] => bundled (2.0.22 compatible) [FreeType Support] => 1 [FreeType Linkage] => with freetype [T1Lib Support] => [GIF Read Support] => 1 [GIF Create Support] => [JPG Support] => 1 [PNG Support] => 1 [WBMP Support] => 1 [XBM Support] => 1 [JIS-mapped Japanese Font Support] => )
image_type_to_mime_type
Возвращает Mime-Type типа изображения.
Синтаксис:
string image_type_to_mime_type( int imagetype)
Функция возвращает MIME-тип картинки, заданный константой в параметре
<?php
header("Content-type: " . image_type_to_mime_type(IMAGETYPE_PNG));
?>
Список констант и возвращаемых значений функции image_type_to_mime_type():
Данная функция не требует наличия библиотеки GD.
Манипулирование изображениями
imageCreate
Создание пустой картинки.
Синтаксис:
int imageCreate(int x, int y)
Создает пустую картинку размером
Пример:
Создание новой картинки при помощи GD и вывод ее в экран браузера:
<?php
header ("Content-type: image/png");
$im = @imagecreate (50, 100)
or die ("Не удается открыть новую картинку!");
$background_color = imagecolorallocate ($im, 255, 255, 255);
$text_color = imagecolorallocate ($im, 233, 14, 91);
imagestring ($im, 1, 5, 5, "A Simple Text String", $text_color);
imagepng ($im);
?>
imageCreateFromPng
Создание рисунка из файла PNG.
Синтаксис:
int imageCreateFromPng(string filename)
Эта функция загружают изображения из файла PNG в память и возвращает его идентификатор. Как и после вызова imageCreate(), дальнейшая работа с картинкой возможна только через этот идентификатор. При загрузке с диска изображение распаковывается и храниться в память уже в неупакованном формате, для того чтобы можно было максимально быстро производить с ним различные операции, такие как масштабирование, рисование линий и т.д.
Пример:
Пример нахождения ошибки при открытии графического файла.
function LoadPNG ($imgname) {
$im = @imagecreatefrompng ($imgname); /* Attempt to open */
if (!$im) { /* See if it failed */
$im = imagecreate (150, 30); /* Create a blank image */
$bgc = imagecolorallocate ($im, 255, 255, 255);
$tc = imagecolorallocate ($im, 0, 0, 0);
imagefilledrectangle ($im, 0, 0, 150, 30, $bgc);
/* Output an errmsg */
imagestring ($im, 1, 5, 5, "Error loading $imgname", $tc);
}
return $im;
}
imageCreateFromJpeg
Создание рисунка из файла JPEG.
Синтаксис:
int imageCreateFromJpeg(string filename)
Эта функция загружают изображения из файла в память и возвращают его идентификатор. Как и после вызова imageCreate(), дальнейшая работа с картинкой возможна только через этот идентификатор. При загрузке с диска изображение распаковывается и храниться в память уже в неупакованном формате, для того чтобы можно было максимально быстро производить с ним различные операции, такие как масштабирование, рисование линий и т.д.
imageCreateFromGif
Создание рисунка из файла GIF.
Синтаксис:
int imageCreateFromGif(string filename)
Эта функция загружают изображения из файла в память и возвращают его идентификатор. Как и после вызова imageCreate(), дальнейшая работа с картинкой возможна только через этот идентификатор. При загрузке с диска изображение распаковывается и храниться в память уже в неупакованном формате, для того чтобы можно было максимально быстро производить с ним различные операции, такие как масштабирование, рисование линий и т.д.
Стоит упомянуть, что GD начиная с версии 1.6 не поддерживает формат GIF. В связи с этим данная функция практически не используется.
imagePng
Функция выводит изображение в PNG-формате в любой браузер или в файл.
Синтаксис:
int imagePng(int im [, string filename])
Эта функция сохраняет изображение, заданное своим идентификатором и находящееся в памяти, на диск, или же выводят его в браузер.
Разумеется, вначале изображение должно быть загружено или создано при помощи функции imageCreate(), т.е. мы должны знать его идентификатор
Если аргумент
Фактически, вы должны вызвать одну из трех команд, в зависимости от типа изображения:
Пример:Пример использования функции imagepng():
<?php
$im = imagecreatefrompng ("test.png");
Header("Content-type: image/png")
imagepng ($im);
?>
imageJpeg
Отсылка рисунка JPEG браузеру или сохранение его в файле.
Синтаксис:
int imageJPEG(int im [, string filename [, int quality]])
Эта функция сохраняет изображение, заданное своим идентификатором и находящееся в памяти, на диск, или же выводит его в браузер.
Разумеется, вначале изображение должно быть загружено или создано при помощи функции imageCreate(), т.е. мы должны знать его идентификатор
Если аргумент
Фактически, вы должны вызвать одну из трех команд, в зависимости от типа изображения:
Третий необязательный параметр
<?php
$im=imageCreateFromJPEG("img/file.jpg");
Header("Content-type: image/jpeg");
imageJPEG($im,"",30);
?>
image2WBMP
Вывод изображения в браузер или файл.
Синтаксис:
int image2WBMP( resource image [, string filename [, int threshold]])
Функция выводит изображение, заданное дескриптором
Если изображение выводится в браузер, необходимо задать его тип WBMP как image/vnd.wap.wbmp функцией Header():
<?php
$file = "php.png";
$image = imagecreatefrompng($file);
header("Content-type: " . image_type_to_mime_type(IMAGETYPE_WBMP));
image2wbmp($image); // Вывод wbmp-картинки в браузер
?>
Функция image2WBMP() доступна PHP только если версия библиотеки GD 1.8 или ниже.
imageGif
Отсылка рисунка GIF браузеру или сохранение его в файле.
Синтаксис:
int imageGIF(int im [, string filename])
Функция сохраняют изображение, заданное своим идентификатором и находящееся в памяти, на диск, или же выводят его в браузер.
Разумеется, вначале изображение должно быть загружено или создано при помощи функции imageCreate(), т.е. мы должны знать его идентификатор
Если аргумент
Фактически, вы должны вызвать одну из трех команд, в зависимости от типа изображения:
Header("Content-type: image/gif")
Т.к. библиотека GD, начиная с версии 1.6, не поддерживает формат GIF, данная функция используется редко.
imageCopy
Копирование части рисунка.
Синтаксис:
int imageCopy(int dst_im, int src_im, int dst_x, int dst_y, int src_x, int src_y, int src_w, int src_h)
Функция копирует прямоугольную область начиная с позиции (
В следующем примере будет картинка
<?php
// Создаем первую картинку на основе готового изображения
$im1=imageCreateFromPNG("img/file1.png");
// Определяем ее размеры
$size_x=imageSX($im1);
$size_y=imageSY($im1);
// Создаем вторую пустую картинку
$im2=imageCreate($size_x,$size_y);
// Копируем рисунок целиком из первого изображения во второе
imageCopy($im2,$im1,0,0,0,0,$size_x,$size_y);
// Сохранение скопированной картинки в файле
imagePNG($im2, "img/file2.png");
?>
imageCopyResized
Копирование части рисунка с масштабированием.
Синтаксис:
int imageCopyResized(int dst_im, int src_im, int dstX, int dstY, int srcX, int srcY, int dstW, int dstH, int srcW, int srcH)
Эта функция - одна из самых мощных и универсальных. С помощью нее можно копировать изображения (или их участки), перемещать или масштабировать их.
Параметры
Наконец, четверка
В следующем примере файл
<?php
$old = imageCreateFromJpeg("img/file1.jpg");
$w = imageSX($old);
$h = imageSY($old);
$w_new=rounr($w/2);
$h_new=round($h/2);
$new = imageCreate($w_new, $h_new);
imageCopyResized($new, $old, 0, 0, 0, 0, $w_new, $h_new, $w, $h);
imageJpeg($new, "img/file2.jpg");
imageDestroy($old);
imageDestroy($new);
?>
imageDestroy
Уничтожение рисунка.
Синтаксис:
int imageDestroy(int im)
Функция уничтожает дескриптор
Работа с цветом в формате RGB
imageColorAllocate
Создание нового цвета и занесение его в палитру рисунка.
Синтаксис:
int imageColorAllocate(int im, int red, int green, int blue)
Функция возвращает идентификатор цвета, связанного с соответствующей тройкой RGB. Первым параметром функция требует идентификатор изображения, загруженного в память или созданного до этого.
Параметры
Практически каждый цвет, который планируется в дальнейшем использовать, должен быть получен (определен) при помощи вызова этой функции.
Пример:Пример использования функции imageColorAllocate():
<?php
. . .
// белый
$white = imagecolorallocate($im, 255, 255, 255);
$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
// черный
$black = imagecolorallocate($im, 0, 0, 0);
$black = imagecolorallocate($im, 0x00, 0x00, 0x00);
. . .
?>
imageColorDeAllocate
Исключение цвета из палитры рисунка.
Синтаксис:
int imageColorDeAllocate(int im, int color)
Эта функция удаляет из палитры рисунка
Пример:Пример использования функции imageColorDeAllocate():
<?php
. . .
$white = imageColorAllocate ($im, 255, 255, 255);
imageColorDeAllocate ($im, $white);
. . .
?>
imageColorSet
Замена цвета определенного элемента палитры.
Синтаксис:
bool imageColorSet(int im, int index, int red, int green, int blue)
Данная функция устанавливает для элемента палитры
imageColorClosest
Получение цвета палитры, наиболее близкого к указанному.
Синтаксис:
int imageColorClosest(int im, int red, int green, int blue)
Вместо того, чтобы пытаться выискать свободное место в палитре цветов, эта функция просто возвращает идентификатор цвета, уже существующего в рисунке и находящегося ближе всего к затребованному. Таким образом, нового цвета в палитру не добавляется. Если палитра не велика, то функция может вернуть не совсем тот цвет, который вы ожидаете. Например, в палитре из трех цветов "красный-зеленый-синий" на запрос желтого цвета будет, скорее всего, возвращен идентификатор зеленого - он ближе всего с точки зрения GD соответствует понятию "зеленый".
imageColorTransparent
Определение цвета прозрачности.
Синтаксис:
int imageColorTransparent(int im [,int color])
Эта функция указывает GD, что соответствующий цвет
Надо отметить, что не все форматы поддерживают задание прозрачного цвета - например, JPEG не может его содержать.
imageColorsForIndex
Получение RGB-составляющих элемента палитры.
Синтаксис:
array imageColorsForIndex(int im, int index)
Функция возвращает ассоциативный массив с ключами
<?php
. . .
$color=imageColorAt($im,0,0);
list($r,$g,$b)=array_values(imageColorsForIndex($im,$color));
echo "R=$r, g=$g, b=$b";
. . .
?>
imageColorAt
Возвращает индекс цвета точки.
Синтаксис:
int imageColorAt(int im, int x, int y)
Эта функция возвращает цвет точки, расположенной на координатах (
<?php
$im = imageCreateFromPng("file.png");
$rgb = ImageColorAt($im, 100, 100);
$r = ($rgb >> 16) & 0xFF;
$g = ($rgb >> 8) & 0xFF;
$b = $rgb & 0xFF;
?>
imageColorsTotal
Получение количества цветов в палитре.
Синтаксис:
int imageColorsTotal(int im)
Функция возвращает число цветов в палитре указанного изображения.
imageColorExact
Получение индекса цвета палитры.
Синтаксис:
int imageColorExact(int im, int red, int green, int blue)
Функция возвращает индекс указанного цвета (
Функция возвратит -1, если указанного цвета нет в палитре изображения.
imageColorResolve
Нахождение или создание указанного цвета.
Синтаксис:
int imageColorResolve(int im, int red, int green, int blue)
Функция возвращает индекс указанного цвета (
В случае, если такой цвет в палитре отсутствует, то он создается.
imageGammaCorrect
Применение гамма-коррекции рисунка.
Синтаксис:
int imageGammaCorrect(int im, double inputgamma, double outputgamma)
Эта функция производит исправления гаммы к изображению, заданному дескриптором
Графические примитивы
imageSetPixel
Рисует пиксель.
Синтаксис:
int imageSetPixel(int im, int x, int y, int color)
Выводит один пиксель цвета
imageLine
Рисует сплошную тонкую линию.
Синтаксис:
int imageLine(int im, int x1, int y1, int x2, int y2, int color)
Эта функция рисует сплошную тонкую линию в изображении
<?php
function imagelinethick($image, $x1, $y1, $x2, $y2, $color, $thick = 1)
{
/* this way it works well only for orthogonal lines
imagesetthickness($image, $thick);
return imageline($image, $x1, $y1, $x2, $y2, $color);
*/
if ($thick == 1) {
return imageline($image, $x1, $y1, $x2, $y2, $color);
}
$t = $thick / 2 - 0.5;
if ($x1 == $x2 || $y1 == $y2) {
return imagefilledrectangle($image,
round(min($x1, $x2) - $t),
round(min($y1, $y2) - $t),
round(max($x1, $x2) + $t),
round(max($y1, $y2) + $t), $color);
}
$k = ($y2 - $y1) / ($x2 - $x1); //y = kx + q
$a = $t / sqrt(1 + pow($k, 2));
$points = array(
round($x1 - (1+$k)*$a), round($y1 + (1-$k)*$a),
round($x1 - (1-$k)*$a), round($y1 - (1+$k)*$a),
round($x2 + (1+$k)*$a), round($y2 - (1-$k)*$a),
round($x2 + (1-$k)*$a), round($y2 + (1+$k)*$a),
);
imagefilledpolygon($image, $points, 4, $color);
return imagepolygon($image, $points, 4, $color);
};
?>
imageDashedLine
Рисует пунктирную линию.
Синтаксис:
int imageDashedLine(int im, int x1, int y1, int x2, int y2, int color)
Эта функция работает почти так же, как и imageLine(), только рисует не сплошную, а пунктирную линию. К сожалению, ни размер, ни шаг штрихов задавать нельзя, так что, если вам обязательна нужна пунктирная линия произвольной фактуры, придется заняться математическими расчетами и использовать imageLine().
imageRectangle
Рисует прямоугольник.
Синтаксис:
int imageRectangle(int im, int x1, int y1, int x2, int y2, int color)
Эта функция рисует в изображении
Левый верхний угол задается
imageFilledRectangle
Зарисовка прямоугольной области.
Синтаксис:
int imageFilledRectangle(int im, int x1, int y1, int x2, int y2, int color)
Эта функция рисует закрашенный прямоугольник в изображении, заданном идентификатором
Эта функция часто применяется для того, чтобы целиком закрасить только что созданный рисунок, например, прозрачным цветом:
<?php
$im=imageCreate(100,100);
$color=imageColorAllocate($i,0,0,0);
imageColorTransparent($im,$color);
imageFilledRectangle($im,0,0,imageSX($im)-1,imageSY($im)-1,$color);
// дальше работаем с изначально прозрачным фоном
?>
imageArc
Рисование части эллипса.
Синтаксис:
int imageArc(int im, int cx, int cy, int w, int h, int s, int e, int color)
Эта функция рисует в изображении
<?php
// создаем изображение размером 200x200
$img = imagecreate(200, 200);
// задаем цвет окружности
$white = imagecolorallocate($img, 255, 255, 255);
// рисуем окружность
imagearc($img, 100, 100, 150, 150, 0, 360, $white);
// вывод рисунка в браузер
header("Content-type: image/png");
imagepng($img);
// закрытие рисунка
imagedestroy($img);
?>
imageFill
Заливка цветом ограниченной области.
Синтаксис:
int imageFill(int im, int x, int y, int color)
Эта функция выполняет сплошную заливку одноцветной области, содержащей точку с координатами (
Две точки называются связанными сильно, если у них совпадает, по крайней мере, одна координата, а по другой координате они отличаются не более, чем на 1 в любую сторону.
imageFillToBorder
Заливка области, ограниченной бордюром.
Синтаксис:
int imageFillToBorder(int im, int x, int y, int border, int color)
Эта функция очень похожа на imageFill(), только она выполняет закраску цветом
imagePolygon
Рисует многоугольник с заданными вершинами.
Синтаксис:
int imagePolygon(int im, array points, int num_points, int color)
Эта функция рисует в изображении
Параметр
<?php
// создаем изображение 400x300
$image = imagecreate(400, 300);
// устанавливаем цвет бордюра многоугольника
$col_poly = imagecolorallocate($image, 255, 255, 255);
// рисуем многоугольник
imagepolygon($image,
array (
0, 0,
100, 200,
300, 200
),
3, $col_poly);
// вывод картинки в браузер
header("Content-type: image/png");
imagepng($image);
?>
imageFilledPolygon
Рисует закрашенный многоугольник с заданными вершинами.
Синтаксис:
int imageFilledPolygon(int im, array points, int num_points, int color)
Эта функция делает практически то же самое, что и imagePolygon(), за исключением одного очень важного свойства: полученный многоугольник целиком заливается цветом
При этом правильно обрабатываются вогнутые части фигуры, если она не выпукла.
<?php
// задаем массив с координатами углов
$values = array(
0 => 40, // x1
1 => 50, // y1
2 => 20, // x2
3 => 240, // y2
4 => 60, // x3
5 => 60, // y3
6 => 240, // x4
7 => 20, // y4
8 => 50, // x5
9 => 40, // y5
10 => 10, // x6
11 => 10, // y6
);
// создаем картинку 250x250
$im = imagecreate(250, 250);
// задаем цвет заполнения многоугольника
$blue = imagecolorallocate($im, 0, 0, 255);
// рисуем многоугольник
imagefilledpolygon($im, $values, 6, $blue );
// вывод каринки в браузер и ее закрытие
header('Content-type: image/png');
imagepng($im);
imagedestroy($im);
?>
Работа с фиксированными шрифтами
Библиотека GD имеет некоторые возможности по работе с текстом и шрифтами. Шрифты представляют собой специальные ресурсы, имеющие собственный идентификатор, и чаще всего загружаемые из файла или встроенные в GD. Каждый символ шрифта может быть отображен лишь в моноцветном режиме, т.е. "рисованные" символы не поддерживаются. Встроенных шрифтов всего 5 (идентификаторы от 1 до 5), чаще всего в них входят моноширные символы разных размеров. Остальные шрифты должны быть предварительно загружены.
imageLoadFont
Загрузка шрифта.
Синтаксис:
int imageLoadFont(string file)
Функция загружает файл шрифтов
Формат файла со шрифтом
Число символов в шрифте (nchars)
Левая колонка задает смещение начала данных внутри файла, а группами цифр, записанных через дефис, определяется, до какого адреса продолжаются данные.
imageFontHeight
Установка высоты шрифта.
Синтаксис:
int imageFontHeight(int font)
Функция возвращает высоту в пикселях символов в заданном шрифте.
imageFontWidth
Установка ширины шрифта.
Синтаксис:
int imageFontWidth(int font)
Функция возвращает ширину в пикселях символов в заданном шрифте.
imageString
Выводит строку в горизонтальном направлении.
Синтаксис:
int imageString(int im, int font, int x, int y, string s, int color)
Функция выводит строку
Если параметр
<?php
// создаем изображение 100x30
$im = imagecreate(100, 30);
// задаем цвет текста
$textcolor = imagecolorallocate($im, 0, 0, 255);
// выводим надпись в верхнем левом углу
imagestring($im, 5, 0, 0, "Hello world!", $textcolor);
// выводим изображение в браузер
header("Content-type: image/jpg");
imagejpeg($im);
?>
imageStringUp
Выводит строку в вертикальном направлении.
Синтаксис:
int imageStringUp(int im, int font, int x, int y, string s, int color)
Эта функция также выводит строку текста, но не в горизонтальном, а в вертикальном направлении.
Верхний левый угол задается координатами (
Если параметр
imageChar
Вывод символа горизонтально.
Синтаксис:
int imageChar(int im, int font, int x, int y, string c, int color)
Функция выводит символ
<?php
// создаем картинку размером 100x100
$im = imagecreate(100, 100);
$string = "PHP";
// задаем цвет символа
$black = imagecolorallocate($im, 0, 0, 0);
// Выведем символ "P" в верхнем левом углу
imagechar($im, 1, 0, 0, $string, $black);
// выведем картинку в браузер
header("Content-type: image/png");
imagepng($im);
?>
imageCharUp
Вывод символа вертикально.
Синтаксис:
int imageCharUp(int im, int font, int x, int y, string c, int color)
Функция выводит символ
Работа со шрифтами TrueType и PostScript Type 1
Библиотека GD поддерживает также работу со шрифтами PostScript и TrueType. Для того чтобы заработали приведенные ниже функции, PHP должен быть откомпилирован и установлен вместе с библиотекой
imageTTFText
Рисование текста шрифтом TrueType.
Синтаксис:
array imageTTFText(int im, int size, int angle, int x, int y, int color, string fontfile, string text)
Эта функция помещает строку
Функция возвращает список из 8 элементов. Первая их пара задает координаты (
Строка текста
При использовании отрицательного значения индекса цвета
Данная функция требует библиотеке GD и FreeType.
<?php
header("Content-type: image/jpeg");
$im = imagecreate(400, 30);
$white = imagecolorallocate($im, 255, 255, 255);
$black = imagecolorallocate($im, 0, 0, 0);
// Replace path by your own font path
imagettftext($im, 20, 0, 10, 20, $black, "/path/arial.ttf",
"Testing... Omega: Ω");
imagejpeg($im);
imagedestroy($im);
?>
Следующий пример выводит строку по центру рисунка
<?php
$gi = imageCreate(200,100);
$bg = imageColorAllocate($gi,0,220,0);
$tx = imageColorAllocate($gi,25,2,228);
$w = imageSX($gi); // ширина рисунка
$h = imageSY($gi); // высота рисунка
imageFilledRectangle($gi,0,0,$w,$h,$bg);
$szf = 20; // размер шрифта
$ang = 240; // угол поворота строки
$str = "Heyou"; // текст строки
$font = "symbol.ttf" // файл шрифта
$sz = imageTTFBBox($szf,$ang,$font,$str);
$sdx = $sz[4]/2;
$sdy = ($sz[7]+$sz[3])/2;
imageTTFText($gi,$szf,$ang,$w/2-$sdx,$h/2-$sdy,$tx,$font,$str);
Header("Content-Type: image/png");
imagePng($gi,"file.png");
?>
imageTTFBBox
Расчет площади, занимаемой строкой шрифта TrueType.
Синтаксис:
array imageTTFBBox(int size, int angle, string fontfile, string text)
Эта функция ничего не выводит в изображение, а просто определяет, какой размер и положение заняла бы строка текста
Возвращаемый список содержит всю информацию о размерах строки в формате, похожем на тот, что выдает функция imageTTFText(). Однако порядок точек в нем отличается.
Содержимое массива, возвращаемого функцией imageTTFBBox():
Координаты могут иметь отрицательные значения.
Функция требует библиотеки GD и FreeType.
imagePSLoadFont
Загрузка из файла шрифта PostScript Type 1.
Синтаксис:
int imagePSLoadFont(string filename)
Возвращает дескриптор загруженного шрифта или FALSE при ошибке (также выводится предупреждение).
<?php
header("Content-type: image/jpeg");
$im = imagecreate(350, 45);
$black = imagecolorallocate($im, 0, 0, 0);
$white = imagecolorallocate($im, 255, 255, 255);
$font = imagepsloadfont("bchbi.pfb"); // or locate your .pfb files on your machine
imagepstext($im, "Testing... It worked!", $font, 32, $white, $black, 32, 32);
imagepsfreefont($font);
imagejpeg($im, "", 100); //for best quality...your mileage may vary
imagedestroy($im);
?>
Эта функция доступна только в том случае, если PHP был скомпилирован с опцией
imagePSFreeFont
Выгрузка шрифта PostScript Type 1.
Синтаксис:
void imagePSFreeFont(int fontindex)
Данная функция освобождает память от шрифта, заданного параметром
Эта функция доступна только в том случае, если PHP был скомпилирован с опцией
imagePSEncodeFont
Установка схемы перекодировки текста.
Синтаксис:
int imagePSEncodeFont(int font_ndex, string encodingfile)
Загружает файл перекодировки
Если перекодировка используется постоянно, установите параметр
Эта функция доступна только в том случае, если PHP был скомпилирован с опцией
imagePsExtendFont
Масштабирование шрифта.
Синтаксис:
bool imagePsExtendFont (int font_index, float extend)
Функция производит растяжение или сжатие шрифта, заданного параметром
Если значение параметра
Эта функция доступна только в том случае, если PHP был скомпилирован с опцией
imagePsSlantFont
Установка наклона шрифта.
Синтаксис:
bool imagePsSlantFont(int font_index, double slant)
Функция устанавливает наклон шрифта
Эта функция доступна только в том случае, если PHP был скомпилирован с опцией
imagePSBBox
Расчет площади, занимаемой строкой шрифта PostScript Type 1.
Синтаксис:
array imagePSBBox( string text, int font, int size [, int space [, int tightness [, float angle]]])
Расчеты производятся на основании аргументов:
Значения
Аргументы
Результаты расчета недостаточно точны. Функция возвращает массив:
Эта функция доступна только в том случае, если PHP был скомпилирован с опцией
imagePSText
Вывод текста поверх рисунка шрифтом PostScript Type 1.
Синтаксис:
array imagePSText ( resource image, string text, int font, int size, int foreground, int background, int x, int y [, int space [, int tightness [, float angle [, int antialias_steps]]]])
Параметр
Координаты
Аргументами
Аргумент
Параметр
Функция возвращает массив, подобно imagepsbbox().
Эта функция доступна только в том случае, если PHP был скомпилирован с опцией
PDF-документы
PDF-функции позволяют PHP создавать PDF-файлы с помощью библиотеки PDF, созданной Томасом Мерзем; также могут потребоваться библиотеки JPEG и TIFF.
С pdflib поставляется хорошая документация, описывающая возможности библиотеки. Имена функций и аргументы идентичны в библиотеке и PHP. Размеры и координаты измеряются в единицах Postscript (72 на дюйм), но это зависит от выбранного разрешения.
Аналогом библиотеки является ClibPDF.
Версии ниже 3.0 pdflib не поддерживается в PHP 4.
<?php
$fp = fopen("test.pdf". "w");
$pdf = pdf_open($fp);
pdf_set_info($pdf, "Author", "Uwe Streinmann");
pdf_set_info($pdf, "Title", "Test for PHP PDFlib");
pdf_set_info($pdf, "Creator", "See Author");
pdf_set_info($pdf, "Subject", "Testing");
pdf_begin_page($pdf, 595, 842);
pdf_add_outline($pdf, "Page 1");
pdf_set_font("$pdf, "Times-Roman", 30, "host");
pdf_set_value($pdf, "textrendering", 1);
pdf_show_xy($pdf, "Times Roman outlined", 50, 750);
pdf_moveto($pdf, 50, 740);
pdf_lineto($pdf, 330, 740);
pdf_stroke($pdf);
pdf_end_page($pdf);
pdf_close($pdf);
fclose($fp);
echo "<A href=getpdf.php>finished</A>";
?>
<?php
// Сценарий getpdf.php просто возвращает документ pdf
$fp = fopen("test.pdf", "r");
header("Content-type: application/pdf");
fpassthru($fp);
fclose($fp);
?>
Введение
PDF-функции позволяют PHP создавать PDF-файлы с помощью библиотеки PDF, созданной Томасом Мерзем; также могут потребоваться библиотеки JPEG и TIFF.
С pdflib поставляется хорошая документация, описывающая возможности библиотеки. Имена функций и аргументы идентичны в библиотеке и PHP. Размеры и координаты измеряются в единицах Postscript (72 на дюйм), но это зависит от выбранного разрешения.
Аналогом библиотеки является ClibPDF.
Версии ниже 3.0 pdflib не поддерживается в PHP 4.
<?php
$fp = fopen("test.pdf". "w");
$pdf = pdf_open($fp);
pdf_set_info($pdf, "Author", "Uwe Streinmann");
pdf_set_info($pdf, "Title", "Test for PHP PDFlib");
pdf_set_info($pdf, "Creator", "See Author");
pdf_set_info($pdf, "Subject", "Testing");
pdf_begin_page($pdf, 595, 842);
pdf_add_outline($pdf, "Page 1");
pdf_set_font("$pdf, "Times-Roman", 30, "host");
pdf_set_value($pdf, "textrendering", 1);
pdf_show_xy($pdf, "Times Roman outlined", 50, 750);
pdf_moveto($pdf, 50, 740);
pdf_lineto($pdf, 330, 740);
pdf_stroke($pdf);
pdf_end_page($pdf);
pdf_close($pdf);
fclose($fp);
echo "<A href=getpdf.php>finished</A>";
?>
<?php
// Сценарий getpdf.php просто возвращает документ pdf
$fp = fopen("test.pdf", "r");
header("Content-type: application/pdf");
fpassthru($fp);
fclose($fp);
?>
Открытие документа
pdf_set_info
Заполнение поля информации документа.
Синтаксис:
void pdf_set_info(int pdf_document, string fieldname, string value)
Возможные поля fieldname:
Функция должна вызываться до создания страниц.
<?php
$fd = fopen("test.pdf", "w");
$pdfdoc = pdf_open($fd);
pdf_set_info($pdfdoc, "Author", "Имя автора");
pdf_set_info($pdfdoc, "Creator", "Название создателя");
pdf_set_info($pdfdoc, "Title", "Заголовок");
pdf_set_info($pdfdoc, "Subject", "Тема");
pdf_set_info($pdfdoc, "Kewwords", "Ключевые, слова");
pdf_set_info($pdfdoc, "CustomField", "Чтото еще");
pdf_begin_page($pdfdoc, 595, 842);
pdf_end_page($pdfdoc);
pdf_close($pdfdoc);
?>
Эта функция заменяет собой pdf_set_info_keyword(), pdf_set_info_title(), pdf_set_info_subject(), pdf_set_info_creator().
pdf_open
Открытие нового документа pdf.
Синтаксис:
int pdf_open(int file)
Функция делает файл, открытый функцией fopen(), документом pdf. Если не указывать дескриптор файла, он создается в памяти и затем может выводиться на стандартный поток вывода или отсылаться броузеру. Функция возвращает дескриптор документа, который следует указывать в последующих pdf-функциях.
pdf_close
Закрытие документа pdf.
Синтаксис:
void pdf_close(int pdf_document)
pdf_begin_page
Начало новой страницы.
Синтаксис:
void pdf_begin_page(int pdf_document, double width, double height)
Аргументы
pdf_end_page
Завершение страницы.
Синтаксис:
void pdf_end_page(int pdf_document)
После этой функции модификация этой страницы невозможна.
Работа с текстом
pdf_show
Вывод текста в текущую позицию.
Синтаксис:
void pdf_show(int pdf_document, string text)
Для вывода используются текущая позиция и текущий шрифт.
pdf_show_boxed
Вывод текста в прямоугольную область.
Синтаксис:
void pdf_show_boxed(int pdf_document, string text, double x, double y, double width, double height, string mode [, string feature])
Левый нижний угол области вывода задается (x:
Аргумент
если они не равны нулю, то
Если аргумент
Функция возвращает число символов, которые не поместились в указанный прямоугольник.
pdf_show_xy
Вывод текста в указанную позицию.
Синтаксис:
void pdf_show_xy(int pdf_document, string text, double x, double y)
pdf_set_font
Выбор шрифта, его размера и кодировки.
Синтаксис:
void pdf_set_font(int pdf_document, string font_name, double size, string encoding [, int embed])
Аргумент вида кодировки
Если для последнего аргумента задано значение 1, шрифт будет внедрен в документ pdf (иначе нет). Если шрифт распространен, внедрять его не следует из-за увеличения размера документа.
Функция должна вызываться после pdf_begin_page().
pdf_set_leading
Установка промежутка между строками текста.
Синтаксис:
void pdf_set_leading(int pdf_document, double distance)
Используется при выводе текста функцией pdf_continue_text().
pdf_set_parameter
Установка строкового значения параметра pdflib.
Синтаксис:
void pdf_set_parameter(int pdf_document, string name, string value)
pdf_get_parameter
Получение строкового значения параметра pdflib.
Синтаксис:
void pdf_get_parameter(int pdf_document, string name [, double modifier])
Аргумент
pdf_set_value
Установка численного значения параметра pdflib.
Синтаксис:
void pdf_set_value(int pdf_document, string name, double value)
pdf_get_value
Получение численного значения параметра pdflib.
Синтаксис:
void pdf_get_value(int pdf_document, string name [, double modifier])
Аргумент
pdf_set_text_rendering
Установка метода вывода текста.
Синтаксис:
void pdf_set_text_rendering(int pdf_document, string mode)
Устарела, используйте pdf_set_value().
pdf_set_horiz_scaling
Установка масштабирования текста по горизонтали.
Синтаксис:
void pdf_set_horiz_scaling(int pdf_document, double scale)
pdf_set_text_rise
Установка подъема текста.
Синтаксис:
void pdf_set_text_rise(int pdf_document, double rise)
pdf_set_text_matrix
Установка матрицы преобразований шрифта.
Синтаксис:
void pdf_set_text_matrix(int pdf_document, array matrix)
Начиная с версии pdflib 2.3 эта функция недоступна.
pdf_set_text_pos
Установка позиции шрифта.
Синтаксис:
void pdf_set_text_pos(int pdf_document, double x-coor, double y-coor)
Устанавливает позицию вывода текста последующим вызовом pdf_show().
pdf_set_char_spacing
Установка интервала между символами.
Синтаксис:
void pdf_set_char_spacing(int pdf_document, double space)
Устарела, используйте pdf_set_value().
pdf_set_word_spacing
Установка интервала между символами.
Синтаксис:
void pdf_set_word_spacing(int pdf_document, double space)
Устарела, используйте pdf_set_value().
pdf_skew
Поворот системы координат.
Синтаксис:
void pdf_skew(int pdf_document, double alpha, double beta)
Угол поворота в градусах указывается относительно осей
pdf_continue_text
Вывод текста со следующей строки.
Синтаксис:
void pdf_continue_text(int pdf_document, string text)
Расстояние между строками может быть установлено функцией pdf_set_leading().
pdf_stringwidth
Вычисление ширины текста.
Синтаксис:
void pdf_stringwidth(int pdf_document, string text)
При вычислении длины строки используется текущий шрифт. Предварительно шрифт должен быть установлен с помощью pdf_set_font().
pdf_save
Сохранение текущих установок.
Синтаксис:
void pdf_save(int pdf_document)
Действует подобно команде
pdf_restore
Восстановление ранее сохраненных установок.
Синтаксис:
void pdf_restore(int pdf_document)
Восстанавливает установки, сохраненные pdf_save(). Действует подобно команде
<?php
pdf_save($pdf);
// всякие вращения и трансформации ...
pdf_restore($pdf);
?>
Установка масштаба и системы координат
pdf_translate
Установка начала системы координат.
Синтаксис:
void pdf_translate(int pdf_document, double x, double y)
Координаты указываются относительно текущей точки отсчета. Затем, до начала рисования объектов, требуется установить текущую точку.
<?php
pdf_moveto($pdf, 0, 0);
pdf_lineto($pdf, 100, 100);
pdf_stroke($pdf);
psd_translate($pdf, 100, 100);
pdf_moveto($pdf, 0, 0);
pdf_lineto($pdf, 100, 100);
pdf_stroke($pdf);
?>
pdf_scale
Установка масштабирования.
Синтаксис:
void pdf_scale(int pdf_document, double x_scale, double y_scale)
<?php
pdf_scale($pdf, 72.0, 72.0);
pdf_lineto($pdf, 1, 1); // на дюйм
pdf_stroke($pdf);
?>
pdf_rotate
Установка угла вращения в градусах.
Синтаксис:
void pdf_rotate(int pdf_document, double angle)
pdf_setflat
Установка равномерности.
Синтаксис:
void pdf_setflat(int pdf_document, double value)
Возможные значения параметра - от 0 до 100.
pdf_setlinejoin
Установка параметра linejoin.
Синтаксис:
void pdf_setlinejoin(int pdf_document, double value)
Возможные значения параметра - от 0 до 2.
pdf_setlinecap
Установка параметра linecap.
Синтаксис:
void pdf_setlinecap(int pdf_document, double value)
Возможные значения параметра - от 0 до 2.
pdf_setmiterlimit
Установка параметра miter limit.
Синтаксис:
void pdf_miterlimit(int pdf_document, double value)
Возможные значения параметра - 1 и более.
pdf_setlinewidth
Установка ширины строк.
Синтаксис:
void pdf_setlinewidth(int pdf_document, double width)
pdf_setdash
Установка текущей точки.
Синтаксис:
void pdf_setdash(int pdf_document, double white, double black)
pdf_moveto
Установка текущей точки.
Синтаксис:
void pdf_moveto(int pdf_document, double x, double y)
Черчение и заполнение фигур
pdf_curveto
Черчение кривой.
Синтаксис:
void pdf_curveto(int pdf_document, double x1, double y1, double x2, double y2, double x3, double y3)
Чертит кривую Безье от текущей точки до (
pdf_lineto
Черчение отрезка.
Синтаксис:
void pdf_lineto(int pdf_document, double x, double y)
Чертит линию от текущей точки до указанной (
pdf_circle
Черчение окружности.
Синтаксис:
void pdf_circle(int pdf_document, double x, double y, double radius)
pdf_arc
Черчение дуги.
Синтаксис:
void pdf_arc(int pdf_document, double x, double y, double radius, double start, double end)
Начальный и конечный угол задаются в
pdf_rect
Черчение прямоугольника.
Синтаксис:
void pdf_rect(int pdf_document, double x, double y, double width, double height)
Левый нижний угол задается (
pdf_closepath
Завершение текущего пути.
Синтаксис:
void pdf_closepath(int pdf_document)
Чертит линию от текущей точки до точки, где начиналась первая линия. Многие функции, например pdf_moveto(), pdf_circle(), pdf_rect() начинают новый путь.
pdf_stroke
Заштриховка пути.
Синтаксис:
void pdf_stroke(int pdf_document)
Текущий путь - это совокупность всех линий. Без этой функции линии начерчены не будут.
pdf_closepath_stroke
Черчение и закрытие пути.
Синтаксис:
void pdf_closepath_stroke(int pdf_document)
Это комбинация pdf_closepath() и pdf_stroke().
pdf_fill
Заполнение пути цветом.
Синтаксис:
void pdf_fill(int pdf_document)
pdf_fill_stroke
Заполнение пути цветом и закрытие его.
Синтаксис:
void pdf_fill_stroke(int pdf_document)
pdf_closepath_fill_stroke
Черчение, закрашивание и закрытие пути.
Синтаксис:
void pdf_closepath_fill_stroke(int pdf_document)
pdf_endpath
Завершение пути без его закрытия.
Синтаксис:
void pdf_endpath(int pdf_document)
pdf_clip
Прикрепление всех линий к текущему пути.
Синтаксис:
void pdf_clip(int pdf_document)
pdf_setgray_fill
Установка заполнения серым цветом.
Синтаксис:
void pdf_setgray_fill(int pdf_document, double gray_value)
pdf_setgray_stroke
Установка штриховки серым цветом.
Синтаксис:
void pdf_setgray_stroke(int pdf_document, double gray_value)
pdf_setgray
Установка заполнения и штриховки серым цветом.
Синтаксис:
void pdf_setgray(int pdf_document, double gray_value)
pdf_setrgbcolor_fill
Установка заполнения цветом RGB.
Синтаксис:
void pdf_setrgbcolor_fill(int pdf_document, double red_value, double green_value, double blue_value)
pdf_setrgbcolor_stroke
Установка штриховки цветом RGB.
Синтаксис:
void pdf_setrgbcolor_stroke(int pdf_document, double red_value, double green_value, double blue_value)
pdf_setrgbcolor
Установка заполнения и штриховки цветом RGB.
Синтаксис:
void pdf_setrgbcolor(int pdf_document, double red_value, double green_value, double blue_value)
pdf_add_outline
Добавление закладки для текущей страницы.
Синтаксис:
void pdf_add_outline(int pdf_document, string text [, int parent [, int open]])
Название закладки определяется аргументом
pdf_set_transition
Установка режима перехода между страницами.
Синтаксис:
void pdf_set_transition(int pdf_document, int transition)
Используйте функцию pdf_set_parameter() с параметром "
pdf_set_duration
Установка интервала между страницами.
Синтаксис:
void pdf_set_duration(int pdf_document, double duration)
Размещение рисунков
pdf_open_gif
Открытие рисунка GIF.
Синтаксис:
void pdf_open_gif(int pdf_document, string filename)
Используйте функцию pdf_open_image_file().
<?php
$im = pdf_open_gif($pdf, "test.gif");
pdf_place_image($pdf, $im, 100, 100, 1);
pdf_close_image($pdf, $im);
?>
pdf_open_png
Открытие рисунка PNG.
Синтаксис:
void pdf_open_png(int pdf_document, string filename)
Используйте функцию pdf_open_image_file().
pdf_open_jpeg
Открытие рисунка JPEG.
Синтаксис:
void pdf_open_jpeg(int pdf_document, string filename)
Используйте функцию pdf_open_image_file().
pdf_open_tiff
Открытие рисунка TIFF.
Синтаксис:
void pdf_open_tiff(int pdf_document, string filename)
Используйте функцию pdf_open_image_file().
pdf_open_image_file
Чтение рисунка из файла.
Синтаксис:
void pdf_open_tiff(int pdf_document, string format, string filename)
Эта функция загружает рисунок формата
Возможные форматы:
<?php
$pim = pdf_open_image_file($pdf, "png", "pic.png");
pdf_place_image($pdf, $pim, 100, 100, 1);
pdf_close_image($pdf, $pim);
?>
Эта функция заменяет pdf_open_image(), pdf_open_gif(), pdf_open_tiff(), pdf_open_png().
pdf_open_memory_image
Открытие рисунка, созданного графическими функциями PHP.
Синтаксис:
void pdf_open_memory_image(int pdf_document, int image)
Функция принимает дескриптор рисунка, созданного PHP, и делает его доступным для документа pdf. Функция возвращает идентификатор рисунка pdf.
<?php
$im = ImageCreate(100, 100);
$col = ImageColorAllocate($im, 80, 45, 190);
ImageFill($im, 10, 10, $col);
$pim = pdf_open_memory_image($pdf, $im);
ImageDestroy($im);
pdf_place_image($pdf, $pim, 100, 100, 1);
pdf_close_image($pdf, $pim);
?>
pdf_close_image
Закрытие рисунка.
Синтаксис:
void pdf_close_image(int pdf_document, int image)
Закрывает рисунок, открытый функциями pdf_open_().
pdf_get_image_height
Установка высоты рисунка в пикселах.
Синтаксис:
void pdf_get_image_height(int pdf_document, int image)
pdf_get_image_width
Установка ширины рисунка в пикселах.
Синтаксис:
void pdf_get_image_width(int pdf_document, int image)
pdf_place_image
Размещение рисунка на странице.
Синтаксис:
void pdf_place_image(int pdf_document, int image, double x, double y, souble scale)
Позиция размещения задается (
pdf_put_image
Сохранение рисунка в pdf для дальнейшего использования.
Синтаксис:
void pdf_put_image(int pdf_document, int image)
Функция внедряет рисунок в документ без его отображения. Затем рисунок может быть размещен на странице функцией pdf_execute_image() необходимое число раз. Полезно при многократной вставке рисунка (уменьшает размер файла).
Начиная с версии 2.01 pdflib функция бесполезна и выводит только предупреждение.
pdf_execute_image
Размещение сохраненного рисунка на странице.
Синтаксис:
void pdf_execute_image(int pdf_document, int image, double x, double y, double scale)
Отображает рисунок, внедренный функцией pdf_put_image().
Начиная с версии 2.01 pdflib функция бесполезна и выводит только предупреждение.
<?php
$im = ImageCreate(100, 100);
$col1 = ImageColorAllocate($im, 80, 45, 190);
ImageFill($im, 10, 10, $col1);
$pim = pdf_open_memory_image($pdf, $im);
pdf_put_image($pdf, $pim);
pdf_execute_image($pdf, $pim, 100, 100, 1);
// 200%
pdf_execute_image($pdf, $pim, 200, 200, 2);
pdf_close_image($pdf, $pim);
?>
Стиль документа
pdf_set_border_style
Установка стиля обрамления примечаний и гиперссылок.
Синтаксис:
void pdf_set_border_style(int pdf_document, string style, double width)
Аргумент
pdf_set_border_color
Установка цвета обрамления примечаний и гиперссылок.
Синтаксис:
void pdf_set_border_color(int pdf_document, double red, double green, double blue)
Три компонента цвета могут принимать значения из диапазона от 0.0 до 1.0
pdf_set_border_dash
Установка стиля окантовки ссылок и примечаний.
Синтаксис:
void pdf_set_border_dash(int pdf_document, double black, double white)
Устанавливает длину черных и белых полос прерывистых линий.
pdf_add_annotation
Добавление примечания.
Синтаксис:
void pdf_add_annotation(int pdf_document, double llx, double lly, double urx, double ury, string title, string content)
Примечание предполагается в нижнем левом углу (
Приложения
Приложения PHP
Переменные окружения
Переменные окружения в PHP
Непосредственно перед запуском сценария сервер передает ему некие переменные окружения с информацией. В определенных переменных содержаться некоторые заголовки, но не все (получить все заголовки нельзя). Далее я приведу список наиболее важных переменных окружения.
HTTP_ACCEPT
- В этой переменной перечислены все MIME-типы данных, которые могут быть восприняты браузером. Строка */* означает, что браузер понимает любой тип.
HTTP_ACCEPT= image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/x-shockwave-flash, application/vnd.ms-excel, application/msword, */*
HTTP_REFERER
- Эта переменная представляет сведения о странице, с которой пользователь попал на данную. Эту переменную можно использовать, например, для отслеживания перемещения пользователя по вашему сайту, а затем просматривать наиболее популярные маршруты.
HTTP_REFERER= http://www.spravkaweb.ru/php/pril/
HTTP_COOKIE
- В этой переменной хранятся все Cookies в URL-кодировке.
HTTP_COOKIE= hotlog=1; ZDEDebuggerPresent=php,phtml,php3; b=b; PHPSESSID=16805922a9258cda274316e60f649cf8
HTTP_USER_AGENT
- Идентифицирует браузер пользователя. Для установления типа браузера нужно проверить эту строку на наличие слов: если браузер - Internet Explorer, то будет присутствовать подстрока MSIE, а если в наличии лишь слово Mozilla, то это Netscape.
Например:
HTTP_USER_AGENT= Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; MyIE2; Maxthon)
HTTP_HOST
- Содержит доменное имя Web-сервера, на котором запустился сценарий. Эту переменную достаточно удобно использовать, например, для генерации полного пути, который требуется в заголовке Location, чтобы не привязываться к конкретному серверу.
HTTP_HOST= www.spravkaweb.ru
HTTP_FROM
- Адрес электронной почты пользователя, направившего запрос.
SERVER_NAME
- Доменное имя или IP-адрес сервера.
SERVER_NAME= www.spravkaweb.ru
SERVER_SOFTWARE
- Имя и версия программы-сервера, отвечающей на запрос клиента.
SERVER_PORT
- Эта переменная содержит порт сервера, к которому обратился браузер пользователя. Обычно это 80. Переменная так-же может применяться для формирования параметра заголовка Location.
SERVER_PORT= 80
SERVER_PROTOCOL
- Переменная содержит имя и версию информационного протокола, который был использован для запроса.
SERVER_PROTOCOL= HTTP/1.1
REMOTE_ADDR
- Эта переменная содержит IP-адрес (или доменное имя) узла пользователя, на котором был запущен браузер.
REMOTE_PORT
- Порт, который закрепляется за браузером пользователя для получения ответа сервера.
REMOTE_USER
- Идентификационное имя пользователя, посылающего запрос.
SCRIPT_NAME
- Содержит имя файла, содержащего данный сценарий. Эту переменную удобно использовать при формировании заголовка Location при переадресации на себя (self-redirect), а также для подставления значения атрибута action тега <form> на странице, которую вызывает сценарий при запуске без параметров (для того чтобы не привязываться к конкретному имени сценария).
DOCUMENT_ROOT
- Корневой каталог дерева Web-документов.
REQUEST_METHOD
- Метод, который применяет пользователь при передаче данных. Надо заметить, что грамотно составленный сценарий должен сам определять на основе этой переменной, какой метод задействует пользователь, и принимать данные из соответствующего источника, а не расчитывать, что передача будет осуществляться, например, только методом POST.
QUERY_STRING
- Содержит параметры, которые в URL указаны после вопросительного знака. Напомним, что они доступны как при методе GET, так и при методе POST (если в последнем случае они были определены в атрибуте action тега <form>).
PATH_INFO
- Содержит дополнительную информацию о пути.
PATH_TRANSLATED
- Та же информация, что и в переменной PATH_INFO с префиксом, задающим путь к корневому каталогу дерева Web-документов.
CONTENT_TYPE
- Медиа-тип данных запроса.
CONTENT_LENGTH
- Возвращает количество байт данных, присланных пользователем. Эту переменную необходимо анализировать, если вы занимаетесь приемом и обработкой POST-формы.
GATEWAY_INTERFACE
- Версия CGI, которую использует сервер.
Пример использования переменных окружения
Далее я приведу пример использования некоторых переменных:
<html>
<head><title>Переменные окружения</title><head>
<body>
<h1>Переменные окружения:</h1>
<hr>
<?
echo "Вы пришли из: ".getenv("HTTP_REFERER")."<BR>";
$br=getenv("HTTP_USER_AGENT");
if(strpos($br,"MSIE")!==false) echo "У вас Internet Explorer<BR>";
else echo "У вас Netscape или др.<BR>";
echo "Ваш IP: ".getenv("REMOTE_ADDR")."<BR>";
echo "Вот параметры в строке браузера: ".getenv("QUERY_STRING");
?>
</body>
</html>
MIME-типы файлов
MIME (Multipurpose Internet Mail Extensions
- Многоцелевые расширения почты интернета, были разработаны как стандарт идентификации различных типов файлов для отправки их по почте, но в последствии их функции были расширены и на другие сервисы Интернета.
Для типа MIME, который приписывается в реестре Windows и используется различными программами, в частности, указывается расширение файла и программа, с помощью которой данный тип файлов будет обрабатываться.
Типы MIME === Тип файла
Архив RAR (.rar) === application/x-tar
Архив ZIP (.zip) === application/x-zip-compressed
Исполняемый файл для DOS или Microsoft Windows (.e === application/octet-stream
Аудио- или видеозапись ASF === video/x-ms-asf
Аудио- или видеозапись WMV === video/x-ms-wmv
Аудиозапись AIFF === audio/aiff
Аудиозапись AU (.au .snd) === audio/basic
Аудиозапись MIDI === audio/mid
Аудиозапись MP3 === audio/mpeg
Аудиозапись WAV (.wav) === audio/x-wav
Аудиозапись WMA === audio/x-ms-wma
Аудиозапись AVI === video/avi
Аудиозапись AVI (.avi) === video/x-msvideo
Видеозапись Indeo (IVF) === video/x-ivf
Видеозапись MPEG (.mpeg .mpg .mpe) === video/mpeg
Видеозапись QuickTime (.qt .mov) === video/quicktime
Визитная карточка, используемая почтовыми программ === text/x-vcard
Графический файл ART === image/x-jg
Графический файл BMP === image/bmp
Графический файл GIF === image/gif
Графический файл JPEG === image/jpeg
Графический файл PNG (.png) === image/png
Графический файл Macromedia Flash === application/futuresplash
Графический файл TIFF === image/tiff
Документ Adobe Acrobat === application/pdf
Документ HTML === text/html
Документ Microsoft Excel === application/x-msexcel
Документ Microsoft Word === application/msword
Документ RTF === application/msword
Документ RTX === text/richtext
Документ XML === text/xml
Приложение === application/x-msdownload
Приложение HTML (HTA) === application/hta
Таблица стилей HTML === text/css
Текстовой документ === text/plain
ECMAScript === text/ecmascript
Microsoft JScript === text/Jscript
Microsoft JScript === text/javascript
Microsoft VBScript === text/vbs
Microsoft VBScript === text/vbscript
Трехмерная интерактивная графика в формате VRML (. === x-world/x-vrml
Советы
Советы по PHP
Запрет кэширования посредством PHP
Запрет кэширования посредством PHP
Большинство сценариев формируют документы, которые при каждом запуске программы изменяются. Очевидно, если браузер пользователя начнет кэшировать такие документы, ничего хорошего не получиться.
Запретить кэшировать документы браузером и Proxy-серверами можно при помощи средств языка PHP, а именно функции Header().
Для этого надо использовать в начале сценария следующие команды:
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.1 Header("Last-Modified: ".gmdate("D, d M Y H:i:s")."GMT");
Для полного запрета кэширования приходиться всегда посылать 4 указанных заголовка, и ни один пропустить нельзя - в противном случае не сработает либо браузер, либо Proxy-сервер.
Создание голосования на PHP
Создание голосования на PHP
Для начала надо определиться, о чем мы будем спрашивать посетителей. Например, понравился им ваш сайт или нет.
Для нашего голосования нам потребуются четыре файла:
Например мы хотим задать посетителям следующие вопросы:
В файл
<form action=golos.php method=post><table cellspacing cellpadding=0 border=0>
<tr><td align=center colspan=2><B>Голосование:</B></td></tr>
<tr><td align=center colspan=2><B>Ваше мнение о сайте:</B></td></tr>
<tr><td><input type=radio name=otv value=1 checked></td><td>Просто супер!</td></tr>
<tr><td><input type=radio name=otv value=2></td><td>Нормальный.</td></tr>
<tr><td><input type=radio name=otv value=3></td><td>Так себе.</td></tr>
<tr><td><input type=radio name=otv value=4></td><td>Мне все равно.</td></tr>
<tr><td><input type=radio name=otv value=5></td><td>Плохой.</td></tr>
<tr><td><input type=radio name=otv value=6></td><td>Хуже не видел!</td></tr>
<tr><td colspan=2 align=center><input type=submit name=golos value="Голосовать"></td></tr></table</form>
После нажатия кнопки
В файл
Создайте файл
Результаты голосования:000000
Первая строка у нас учитываться не будет.
В остальные шесть строк надо ввести нули, нажимая после каждой цифры клавишу
В файле
<html>
<head>
<title>Обработка голосования</title>
</head>
<body>
<?php
if(@$golos) {
// Здесь мы запускаем обработку данных только если
// была нажата клавиша Голосовать
$file_name="data.txt";
// Переменная $file_name задает имя файла с результатами
$file=file($file_name);
// Записываем файл с данными в массив $file
$file_len=count($file);
// $file_len - количество строк в файле data.txt
for($i=1,$n=0;$i<$file_len;$i++) {
$file[$i]=trim($file[$i]);
$n=$n+$file[$i];
};
// В этом цикле мы убираем символы перевода строки и записываем в
// переменную $n сколько человек уже проголосовало
echo "<center><h2>Спасибо, Ваше мнение учтено!</h2></center>";
$file[$otv]++;
$n++;
// Здесь мы учитываем номер ответа, который пришел к нам из формы,
// увеличив соответствующее значение в массиве и число проголосовавших на 1
$rez="Результаты голосования:n";
// Переменная $rez будет содержать данные о голосовании,
// которые затем запишем обратно в файл
for($i=1;$i<$file_len;$i++) $rez.=$file[$i]."n";
$rez=trim($rez);
$file_rec=@fopen($file_name,"w");
// Здесь мы создаем новый файл, в который затем запишем обновленные данные
if($file_rec) {
$counter=fputs($file_rec,$rez);
// Запись обновленных данных в файл data.txt
fclose($file_rec);
}
else echo "Произошла ошибка записи результатов!";
for($i=1;$i<$file_len;$i++) $pr[$i]=round(($file[$i]/$n)*100);
// Записали в массив $pr, сколько процентов от общего числа голосовавших
// занимает каждый ответ
// Далее идет кусок HTML-кода, который
// отвечает за вывод наших данных на экран
?>
<center><h2>Ваше мнение о сайте:</h2></center><BR>
<table border=1 align=center>
<tr><td>
<B>Просто супер! (<?php echo $file[1];?>):</B>
</td><td>
<img src="img.php?pr=<?php echo $pr[1];?>" height=15>
</td></tr>
<tr><td>
<B>Нормальный. (<?php echo $file[2];?>):</B>
</td><td>
<img src="img.php?pr=<?php echo $pr[2];?>" height=15>
</td></tr>
<tr><td>
<B>Так себе. (<?php echo $file[3];?>):</B>
</td><td>
<img src="img.php?pr=<?php echo $pr[3];?>" height=15>
</td></tr>
<tr><td>
<B>Мне все равно. (<?php echo $file[4];?>):</B>
</td><td>
<img src="img.php?pr=<?php echo $pr[4];?>" height=15>
</td></tr>
<tr><td>
<B>Плохой. (<?php echo $file[5];?>):</B>
</td><td>
<img src="img.php?pr=<?php echo $pr[5];?>" height=15>
</td></tr>
<tr><td>
<B>Хуже не видел! (<?php echo $file[6];?>):</B>
</td><td>
<img src="img.php?pr=<?php echo $pr[6];?>" height=15>
</td></tr>
</table>
<table border=1 align=center>
<tr><td align=center><B>Всего проголосовало:</B></td></tr>
<tr><td align=center><?echo $n." человек";?></td></tr>
</table>
<?
};
?>
</body>
</html>
Записав в атрибут SRC тега <IMG> значение "img.php?pr=количество процентов" мы тем самым передаем файлу
Далее приведу листинг файла
<?php
$otstup=35;
// $otstup - задает отступ, в прелелах которого
// в картинку впишем процентное значение
$string=$pr."%";
// $string - содержит значение процентов плюс знак процента
$im=imageCreate($pr*2+$otstup,15);
// Здесь создаем идентификатор, при помощи
// которого мы будем работать с картинкой
$fon=imageColorAllocate($im,220,20,60);
$fon1=imageColorAllocate($im,255,20,147);
// Задаем цвет фона
$col_b=imageColorAllocate($im,0,0,0);
// Задаем цвет обводки
$shrift=imageColorAllocate($im,255,255,255);
// Цвет вывода процентного значения
imageFill($im,2,2,$fon);
// Заполнили наш прямоугольник основным фоном
$x1=0;$x2=$pr*2+$otstup-1;
$y1=0;$y2=14;
// Формирование улов для обводки контуром
imageLine($im,$x1,$y1,$x2,$y1,$col_b);
imageLine($im,$x2,$y1,$x2,$y2,$col_b);
imageLine($im,$x2,$y2,$x1,$y2,$col_b);
imageLine($im,$x1,$y1,$x1,$y2,$col_b);
imageLine($im,$x1+$otstup,$y1,$x1+$otstup,$y2,$col_b);
// Создание контура и разделяющей полосы
if($pr!=0) imageFill($im,$otstup+1,2,$fon1);
// Если значение процента не равно 0, то заполняем
// правую часть цветом $fon1
imageString($im,3,5,1,$string,$shrift);
// Пишем в правую часть картинки процентное значение
header("Content-type: image/png");
imagePng($im);
imageDestroy($im);
// Здесь производим вывод полученной картинки в
// стандартный поток вывода и уничтожаем идентификатор
?>
Отправка писем при помощи PHP
Отправка писем при помощи PHP
Рано или поздно каждый владелец сайта сталкивается с необходимостью отправки писем непосредственно с сайта через скрипт, а не через почтовые программы. Это могут быть письма, отправляемые скриптом гостевой книги, сообщающее владельцу сайта что у него в гостевой появилось новое сообщение, или форумом, для оповещения о новом вопросе.
Во всех этих случаях необходима именно автоматическая отправка писем миную разнообразные почтовые программы и утилиты.Сделать это можно при помощи функции mail(), которую мы сейчас и будем изучать.
Синтаксис функции mail():
bool mail(string $to, string $subject, string $msg [, string $header]);
Функция mail() посылает письмо с темой
Если Вы хотите, чтобы письмо ушло по нескольким адресам, разделите их пробелами.
Само сообщение может быть многострочным. Для перехода на новую строку поставьте знак перехода на новую строку "\n" в конце каждой строки.
mail("name@mail.ru", "my subject", "stroka1nstroka2nstroka3");
Или тотже самое можно записать так:
mail("name@mail.ru", "my subject", "stroka1
stroka2
stroka3");
В четвертом необязательном параметре
Под заголовками я подразумеваю информацию, передаваемую вместе с письмом почтовому клиенту, которая будет содержать некоторые технические данные, такие как: кодировка письма, имя отправителя, обратный адрес отправителя и т.д. Это схоже с использованием тега <META> в HTML.
Чтобы было более понятно, что из себя представляют заголовки, и где они находятся в письме, откройте почтовый клиент и посмотрите на любое письмо в том виде, как оно пришло (
Как мы видим, письмо представляет простой текстовой файл, состоящий из двух общих разделов:Вверху идут заголовки письма, затем через две строки идет само письмо.
Заголовков письма достаточно много, но не все они используются при написании скрипта отправки почты.
Вот некоторые наиболее часто используемые:
Я не зря выше привел пример отправки письма со словами латинского алфавита. Их любой почтовый клиент прочтет без труда. Но вот с русским алфавитом труднее. Русских кодировок существует огромное множество. И от того, насколько умело Вы перекодируете письмо, будет зависеть прочтет ли получатель его, или не будет возиться с установкой нужной кодировки и просто удалит его в корзину.
Кодировку письма задает заголовок
$header="From: "Evgen" <evgen@mail.ru>";
$header.="Content-type: text/plain; charset="windows-1251"";
$subject="Тема письма";
$msg="Сторака 1nСтрока 2nСтрока 3";
mail("name@mail.ru", $subject, $msg, $header);
В заголовке мы указали, что тип письма будет простой текст, а кодировка - Windows.
Теперь наше письмо придет в понятной для почтового клиента кодировке.
Но стоит отметить, что в некоторых случаях в правильной кодировке будет отображено только само письмо. Заголовок же так и останется нечитаемым. Связано это с тем, где расположен заголовок
$subject="Тема письма";
$header="Content-type: text/plain; charset="windows-1251"";
$header.="From: Evgen <evgen@mail.ru>";
$header.="Subject: $subject";
$header.="Content-type: text/plain; charset="windows-1251"";
$msg="Сторака 1nСтрока 2nСтрока 3";
mail("name@mail.ru", $subject, $msg, $header);
Теперь это письмо прочтет любая почтовая программа!
Для отправки письма в HTML-виде достаточно в заголовке
А само письмо записать в html-виде:
$subject="Тема письма";
$header="Content-type: text/html; charset="windows-1251"";
$header.="From: Evgen <evgen@mail.ru>";
$header.="Subject: $subject";
$header.="Content-type: text/html; charset="windows-1251"";
$msg="<body>
<li>Сторака 1
<li>Сторака 2
<li>Сторака 3
</body>";
mail("name@mail.ru", $subject, $msg, $header);
Смотреть также
Из PHP в Excel: работа с COM-объектами
Данная серия статей посвящена созданию документов Excel при помощи PHP. Данная возможнось может понадобиться, например, если нужно предоставить пользователю загружаемые данные в виде листов Excel. Это могут быть прайсы на продукцию, автоматически генерируемые из базы данных на сервере, либо какие-то документы, которые также необходимо представить в виде документов Excel.
Здесь рассматривается возможность работы с Excel-документами через COM-объект. К сожалению работа с COM-объектами в PHP возможна только на Windows-платформах. По-этому если Вы используете Unix-хостинг, то создавать и редактировать Excel-документы приведенным ниже способом не получится.
Работа с COM-объектами производится при помощи синтаксиса
$com_object = new COM($object);
где
Для создания Excel-документов переменной
$xsl = new COM("Excel.Application");
После создания нового COM-объекта, можно обращаться к его свойствам и методам:
<?php
$xls = new COM("Excel.Application"); // Создаем новый COM-объект
$xls->Application->Visible = 1; // Заставляем его отобразиться
$xls->Workbooks->Add(); // Добавляем новый документ
$rangeValue = $xls->Range("A1");
$rangeValue->Value = "В выделенном блоке текст будет жирный, подчеркнутый, наклонный";
$rangeValue = $xls->Range("A2");
$rangeValue->Value = "Шрифт будет иметь высоту 12";
$rangeValue = $xls->Range("A3");
$rangeValue->Value = "Имя шрифта - Times New Roman";
$range=$xls->Range("A1:J10"); // Определяем область ячеек
$range->Select(); // Выделяем ее
$fontRange=$xls->Selection(); // Присваиваем переменной выделенную область
// Далее задаем параметры форматирования текста в выделенной области
$fontRange->Font->Bold = true; // Жирный
$fontRange->Font->Italic = true; // Курсив
$fontRange->Font->Underline = true; // Подчеркнутый
$fontRange->Font->Name = "Times New Roman"; // Имя шрифта
$fontRange->Font->Size = 12; // Размер шрифта
?>
Полезные ссылки
Форум по PHP
http://forum.spravkaweb.ru/index.php?showforum=2
Официальный сайт PHP
www.php.net
Библиотека скриптов PEAR
pear.php.net