Просмотр файла readme_rus.html

Размер файла: 12.18Kb
<html>
<title>WAP BASIC (PHP-WAP-BASIC MOD)</title>
<head>
<link href="styles.css" rel="stylesheet" type="text/css\">
</head>
<body>
<big>WAPBASIC V1.0 &copy; 2006 [email protected]</big><br/>
<b>Короткое вступление.</b>
<p align="justify">
Данные модуль, не претендует на &quot;звание&quot; языка 
программирования и тем более на какую-либо профессиональную<br/>
среду разработки WEB и WAP приложений. Это просто маленькая 
помощь тем, кто только начинает изучать PHP и WML.<br/>
Тут не будет описания команд, как таковых, а только примеры 
использования WAPBASIC.<br/>
<b>С чего начать?</b><br/>
Для начала нужно создать PHP файл, например в блокноте, с 
любым произвольным именем, создадим: <strong>index.php</strong><br/>
Напишем в нём следующий текст:<br/>
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
&lt;?<br/>
include (&quot;system.php&quot;);<br/>
WB_noerrors();<br/>
WB_autoheader (&quot;index&quot;,&quot;Первый файл&quot;,&quot;0&quot;,&quot;&quot;);<br/>
&nbsp;&nbsp;_startalign ();<br/>
&nbsp;WB_print(&quot;Мой первый файл&quot;);<br/>
WB_br(1);<br/>
WB_showline();<br/>
&nbsp;&nbsp;_endalign ();<br/>
WB_autoclose ();<br/>
DIE(&quot;&quot;);<br/>
?&gt;
</i>
</td></tr></table>
<br/>
<strong>Давайте теперь рассмотрим более детально наш код.</strong><br/>
<strong>include (&quot;system.php&quot;);</strong><br/>
Данной командой мы подключаем библиотеку WAPBASIC (system.php).<hr/>
<strong>WB_noerrors();</strong><br/>
А эта команда отключает показ критических ошибок в PHP коде.<hr/>
<strong>WB_autoheader (&quot;index&quot;,&quot;Первый файл&quot;,&quot;0&quot;,&quot;&quot;);</strong><br/>
На этой команде стоит остановиться подробней!<br/>
Во-первых, данная команда автоматически создаёт заголовок 
для WAP или WAP2.0 (XHTML) документа.<br/>
index=card id, Первый файл=title<br/>
0=Время в милисекундах, через которое страница обновится.<br/>
И последние кавычки, по какому адресу будет обновление.<br/> 
<strong>Например:</strong><br/>
WB_autoheader (&quot;index&quot;,&quot;Первый файл&quot;,&quot;600&quot;,&quot;index.php&quot;);<br/>
Обновит страницу index.php через 10 секунд.<br/>
<u>Для WAP2.0 версии желательно присутствие файла styles.css</u>
<hr/>
<strong>_startalign ();</strong><br/>
После этой команды идёт основная программа. Данная команда, 
форматирует вывод текста на экран. И имеет три вида:<br/>
_startalign (); - Вывод текста по левому краю.<br/>
_startaligncenter (); - Вывод текста по центру.<br/>
_startalignright (); - Вывод текста по правому краю.
<hr/>
<strong>WB_print(&quot;Мой первый файл&quot;);</strong><br/>
Аналог бейсиковской команды <b>PRINT</b>. Выводит текст 
в кодировке UTF8. Позволяет включать тэги в текст и переменные.<br/>
<strong>Например:</strong><br/>
$name=&quot;ВАСЯ ПЛЮШКИН&quot;;<br/>
WB_print(&quot;&lt;b&gt;Привет, $name&lt;/b&gt;&quot;);
<hr/>
<strong>WB_br(1);</strong><br/>
Команда переноса строки! <u>ОЧЕНЬ НУЖНАЯ КОМАНДА</u><br/>
Параметр в скобках показывает на сколько линий осуществить 
перенос строки. Пишется после любой команды вывода WAPBASIC.<br/>
Аналог тега: <b>&lt;br/&gt;</b>
<hr/>
<strong>WB_showline();</strong><br/>
Команда вывода линии на экран. Адаптирована для WAP и WAP2.0 (XHTML).
<hr/>
<strong>_endalign ();</strong><br/>
Команда окончания форматирования текста. Закрывает любой из:<br/>
_startalign ();<br/>
_startaligncenter ();<br/>
_startalignright ();<hr/>
<strong>WB_autoclose ();</strong><br/>
Показывает, что документ окончен.<hr/>
<strong>DIE(&quot;&quot;);</strong><br/>
Показывает, что дальше програмного кода нет. <u>Обязательна</u> 
после: WB_autoclose ();
<hr/>
Фактически, можно использовать такую конструкцию (шаблон):<br/>
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
&lt;?<br/>
include (&quot;system.php&quot;);<br/>
WB_noerrors();<br/>
WB_autoheader (&quot;index&quot;,&quot;Первый файл&quot;,&quot;0&quot;,&quot;&quot;);<br/>
&nbsp;&nbsp;_startalign ();<br/>
...КОД PHP, WML, ИЛИ HTML<br/>
&nbsp;&nbsp;_endalign ();<br/>
WB_autoclose ();<br/>
DIE(&quot;&quot;);<br/>
?&gt;
</i>
</td></tr></table> 
<br/>
<strong>Давайте, посмотрим, какие типы заголовков бывают ещё.</strong><br/>
<em>WB_wapheader (&quot;id&quot;,&quot;title&quot;,&quot;time&quot;,&quot;url&quot;);</em><br/>
Заголовок для WAP документов. Т.е если сайт ориентирован <u>ТОЛЬКО</u> на WAP.<br/>
Закрывается командой: <em>WB_wapclose ();</em><br/>
<em>WB_xhtmlheader (&quot;id&quot;,&quot;title&quot;,&quot;time&quot;,&quot;url&quot;);</em><br/>
Заголовок для XHTML (WAP2.0, WEB) документов. Т.е если сайт ориентирован <u>ТОЛЬКО</u> на WAP2.0 или WEB.<br/>
Закрывается командой: <em>WB_xhtmlclose ();</em><br/>
В WAPBASIC, есть встроенная переменная, по которой можно 
определить вошли-ли вы с WAP устройства или с компьютера.<br/>
Вот эта переменная: <strong>$iswap</strong><br/>
Вот код, который проверяет WAP вход или WAP2.0:<br/>
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
if ($iswap==&quot;false&quot;) {<br/>
WB_print (&quot;ВЫ ТУТ С КОМПА!&quot;);<br/>
&nbsp;} else {<br/>
WB_print (&quot;ВЫ ТУТ С ТЕЛЕФОНА!&quot;);<br/>
&nbsp;&nbsp;}<br/>
</i>
</td></tr></table><br/>
<strong>Перейдём к рассмотрению дополнительных функций.</strong><br/> 
WAPBASIC имеет функции простого создание ссылок, картинок, полей ввода текста.<br/>
Начнём с ссылки. Если вам знакомы теги HTML, то вы знаете:<br/>
Чтобы создать ссылку, нужно написать:<br/>
<em>
&lt;a href=&quot;http://путь_к_сайту&quot;&gt;На сайт&lt;/a&gt;
</em><br/>
Как это неудобно! Посмотрим как это делается в WAPBASIC:<br/>
<em>
WB_link(&quot;http://путь_к_сайту&quot;,&quot;На сайт&quot;);</em><br/>
Правда ведь проще? :)<br/>
Теперь вывод картинки:<br/>
<em>
WB_image (&quot;http://путь_к_картинке&quot;,&quot;описание&quot;);
</em><br/>
Создаём поле ввода:<br/>
<em>
WB_input (&quot;text&quot;,&quot;test&quot;,&quot;HELLO&quot;,&quot;20&quot;);
</em><br/>
Мы создали поле для ввода текста (<strong>text</strong>), 
который будет сохранён в переменную (<strong>test</strong>),<br/>
Начальное значение переменной будет (<strong>HELLO</strong>),
а максимальный размер ввода 20 символов.<br/>
Пример:
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
&lt;?<br/>
include (&quot;system.php&quot;);<br/>
WB_noerrors();<br/>
WB_autoheader (&quot;index&quot;,&quot;Первый файл&quot;,&quot;0&quot;,&quot;&quot;);<br/>
&nbsp;&nbsp;_startalign ();<br/>
&nbsp;WB_print(&quot;Ваше имя (макс. 20):&quot;);<br/>
WB_br(1);<br/>
WB_input (&quot;text&quot;,&quot;name&quot;,&quot;Alex5&quot;,&quot;20&quot;);<br/>
WB_br(1);<br/>
&nbsp;&nbsp;_endalign ();<br/>
WB_autoclose ();<br/>
DIE(&quot;&quot;);<br/>
?&gt;
</i>
</td></tr></table>
Просто запустите и посмотрите результат!<br/>
Вместо параметра <strong>text</strong>, могут быть следующие 
параметры:<br/>
password - ввод пароля<br/>
submit - кнопка отправки формы<br/>
И другие, стандартные параметры input.<br/>
Кстати, разговор о формах ещё не закончен :)<br/>
<u>Внимание! Не забываете ставить после команд вывода WB_br(1);.</u><br/>
Рассмотрим ещё две интересные функции WAPBASIC!<br/>
<strong>WB_rndword (&quot;имя_файла&quot;);</strong><br/>
Функция выводит случайную фразу из файла: <strong>имя_файла</strong>.<br/>
Не стану долго описывать функцию, просто приведу пример.<br/>
Создайте файл: friends.txt и запишите следующий текст:<br/>
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
ПЕТЯ<br/>
ВАСЯ<br/>
МАНЯ<br/>
ВАНЯ<br/>
СЕРЁЖКА<br/>
[email protected]<br/>
</i>
</td></tr></table>
Теперь, сохраните файл. Напишем такой код:<br/>
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
&lt;?<br/>
include (&quot;system.php&quot;);<br/>
WB_noerrors();<br/>
WB_autoheader (&quot;index&quot;,&quot;Первый файл&quot;,&quot;0&quot;,&quot;&quot;);<br/>
&nbsp;&nbsp;_startalign ();<br/>
&nbsp;$friend=WB_rndword (&quot;friends.txt&quot;);<br/>
&nbsp;WB_print (&quot;У вас есть хороший друг: $friend&quot;);<br/>
&nbsp;&nbsp;_endalign ();<br/>
WB_autoclose ();<br/>
DIE(&quot;&quot;);<br/>
?&gt;
</i>
</td></tr></table>
Теперь запустите и посмотрите полученный код.<br/>
Ещё одна полезная функция, позволяет вывести файл на экран. 
Выводит с тегами и.т.д в кодировке UTF8.<br/>
<strong>WB_showfile (&quot;имя_файла&quot;);</strong><br/>
Выводит текст из файла на экран. Поддерживает теги HTML и WML.
<hr/>
<strong>Короткое отступление. Или &lt;anchor&gt; и &lt;form&gt;.</strong><br/>
Всем, конечно хороши две версии сайта. И WAP радует и WAP2.0 отличный, но 
есть маленькая проблемка, а именно <b>ФОРМЫ</b>. Поэтому многие и 
делают только одну версию сайта. Или WAP или WEB.<br/>
В WAPBASIC есть удобное решение вывода различных форм, для 
различных версий сайта (<small>Требует знание WML и HTML</small>).<br/>
Итак, чтобы не нарушать дизайн и не использовать сложные XML (XSL) средства, 
вы можете воспользоваться функцией:<br/>
<strong>WB_addform(&quot;имя_файла_формы&quot;);</strong><br/>
Как работает данная функция? А очень просто!<br/>
Для каждого из вариантов сайта можно создать свою форму.<br/>
Приведу пример использования функции:<br/>
<em>
WB_addform(&quot;login&quot;);</em><br/>
Данная команда, будет работать сразу с двумя формами, которые 
вам придётся создать. Для версии WAP: <strong>login.wapf</strong>, 
для версии WAP2.0 или WEB: <strong>login.webf</strong>.<br/>
Содержание форм:<br/>
<small>login.wapf</small>
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
Введите ваше имя:&lt;br/&gt;<br/>
&lt;input type=&quot;text&quot; name=&quot;nam&quot; value=&quot;&quot;/&gt;&lt;br/&gt;<br/>
&lt;anchor&gt;Принять<br/>
&lt;go href=&quot;name.php&quot; method=&quot;get&quot;&gt;<br/>
&lt;postfield name=&quot;nam&quot; value=&quot;$(name)&quot;/&gt;<br/>
&lt;/go&gt;&lt;/anchor&gt;&lt;br/&gt;<br/>
</i>
</td></tr></table>
<small>login.webf</small>
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
&lt;form action=&quot;name.php&quot; method=&quot;get&quot;&gt;
Введите ваше имя:&lt;br/&gt;<br/>
&lt;input type=&quot;text&quot; name=&quot;nam&quot; value=&quot;&quot;/&gt;&lt;br/&gt;<br/>
&lt;input type=&quot;submit&quot; value=&quot;Принять&quot;/&gt;&lt;br/&gt;<br/>
&lt;/form&gt;
</i>
</td></tr></table>
Теперь создадим файл <strong>name.php</strong> и напишем код:<br/>

<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
&lt;?<br/>
include (&quot;system.php&quot;);<br/>
WB_noerrors();<br/>
$nam=$_GET[&quot;nam&quot;];
WB_autoheader (&quot;index&quot;,&quot;Первый файл&quot;,&quot;0&quot;,&quot;&quot;);<br/>
&nbsp;&nbsp;_startalign ();<br/>
WB_print (&quot;Приняли имя: [$nam]&quot;);<br/>
WB_br(1);<br/>
WB_addform(&quot;login&quot;);<br/>
&nbsp;&nbsp;_endalign ();<br/>
WB_autoclose ();<br/>
DIE(&quot;&quot;);<br/>
?&gt;
</i>
</td></tr></table>
Можете посмотреть на результат работы.<hr/>
<strong>ФУНКЦИИ, ОСТАВШИЕСЯ ЗА КАДРОМ.</strong><br/>
В WAPBASIC осталось ещё несколько функций, которые <u>ВОЗМОЖНО</u> вам пригодяться.<br/>
<br/>
<strong>WB_filecount (&quot;имя_файла&quot;);</strong><br/>
Функция подсчитывает кол-во записей в файле. Пример:<br/>
<em>
$myfriends=WB_filecount (&quot;friends.txt&quot;);<br/>
WB_print (&quot;У меня есть $myfriends друзей!&quot;);<br/>
</em><br/>
<hr/>
<strong>_urlredirect (&quot;http://путь&quot;);</strong><br/>
Функция переадресовывает посетителя на другой сайт.<br/>
Пример кода:<br/>
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
&lt;?<br/>
include (&quot;system.php&quot;);<br/>
_urlredirect(&quot;http://in2wap.net&quot;);<br/>
DIE(&quot;&quot;);<br/>
?&gt;
</i>
</td></tr></table>
Заметьте! Заголовки не описываются!!! Иначе будет ошибка!<hr/>
<strong>wchrformat (&quot;текст&quot;); и uchrformat (&quot;текст&quot;);</strong><br/>
wchrformat (&quot;текст&quot;); - переводит текст в кодировку WINDOWS-1251.<br/>
uchrformat (&quot;текст&quot;); - переводит текст в кодировку UTF8.<br/>
Прелесть этих функций в том, что они работают с <u>любыми</u> кодировками.<hr/>
<strong>browser_type();</strong><br/>
Показывает ваш браузер или модель вашего телефона.<hr/>
<br/><br/>
Автор очень надеется, что WAPBASIC и данное руководство помогут 
начать изучение PHP и сделать ваши WAP сайты более привлекательными.<br/>
Просьба ко всем пользователям: <u>НЕ ВНОСИТЬ ИЗМЕНЕНИЯ В ИСХОДНЫЙ КОД system.php</u>
</p>
С Уважением, &copy; 2006 <a href="mailto:[email protected]">In2W@P</a><br/>
</body>
</html>