Приложение Д: скрипты php, описание, примеры, php файлы, комментарии

Последняя модификация: 10.08.2014 г

Страница загружена с адреса: http://webdesign.site3k.ru/conjuncture/append/d/inter.html

Интерактивность материала

Выбор типа интерактивности
PHP-скрипт комментария

Выбор типа интерактивности.

Ничто не увеличивает посещаемость сайта так, как возможность живого общения. По этой причине многие веб-ресурсы снабжены форумами, гостевыми книгами и чатами. Но нужно ли это именно вам?

Нужен ли вам чат?

Зайдите на любой сайт имеющий чат и посмотрите содержание чата. Что вы увидите? Фразы, вроде «Мужики, вы чё делаете?», «Пиво пьете?», «А мы курим». Врядли такой материал добавит сайту уважения и популярности. А если его еще и поисковые машины проиндексируют, то словесный мусор вашего чата резко понизит значимость ключевых слов. И вместо желаемой популярности, получится ее снижение в результате меньшего притока посетителей с сайтов поисковых систем, так как ваши страницы будут выталкиваться в конец результатов поиска из-за большого количества никому не нужного словоблудия.

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

Нужна ли вам гостевая книга?

Чтобы ответить на этот вопрос, следует разобраться, что это такое? Гостевая книга – это, своего рода, книга жалоб и предложений, где посетителю предоставлена возможность изложить свое мнение о сайте. Возможно, она нужна вам, если сайт предлагает какие-то услуги, то отзывы клиентов могут оказать благотворное влияние на потенциальных клиентов. Но многие хорошие сайты обходятся без нее. С одной стороны – мало ли кому и чего захочется написать? А с другой стороны – есть и другие способы узнать мнение посетителей. Есть же голосования, почта. Хотят поделиться мнением – пусть напишут лично вам. Нередки случаи, когда в гостевой книге пишут то, что и на заборах. Нужны ли вам такие перлы?

Форум?

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

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

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

Цель форума – дискуссии на свободные темы. Возможно, форум нужен вашему сайту. Но если вы хотите организовать обсуждение ваших статей, то вам нужны специальные скрипты комментариев.

Задумав дополнение статей всякими комментариями, замечаниями и обсуждениями, следует, в первую очередь, как эти примечания выводить в браузер. Альтернатив всего три:

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

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

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

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

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

PHP-скрипт комментария

Для полного понимания скрипта, следует определить его концепции:

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

Определив концепции, можно взяться за их воплощение.

Поскольку каждая статья должна иметь свои комментарии, добавление ссылки на вызов комментария имеет смысл реализовать таким образом:

<a href="/comment/comment.php?htm=<!--#echo var="DOCUMENT_URI" -->" target=_blank> Комментарии к странице <!--#include virtual="/comment/count.php?htm=${DOCUMENT_URI}" --></a>

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

В связи с разделением функций на два скрипта, возникает потребность вынести определение общих для них переменных, ограничивающих длину полей и количество сообщений на странице в отдельный файл, включаемый в них PHP-оператором require. Назовем этот файл setings.php. Вот его содержимое:

setings.php

<?
$maxlines=10; // количество сообщений на странице (требуется только для comment.php)
$maxlen=35;   // длина полей имени, названия города и т. п.
$maxlenMes=1000;// длина сообщения
?>

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

Определив переменные, создадим простой скрипт, выдающий на страницу количество комментариев:

count.php

<?
require("setings.php") ; // здесь обработать как PHP
$filename = $DOCUMENT_ROOT.$_GET['htm'].'.csv'; // Занесем имя файла в переменную
// $DOCUMENT_ROOT определяет путь к корню сайта
// $_GET['htm'] получает значение переменной htm из GET-запроса (имя коментируемого файла и путь к нему)
// .csv – расширение файла с коментариями. Если название файла со статьей page.html, то файл с коментариями к ней будет называться page.html.csv и находиться в том же каталоге, где и статья.
if (is_readable($filename)) { // если файл читается
  $f = fopen($filename,"r") or die("Ошибка открытия базы"); // Открываем файл и заносим его указатель в переменную
  for($i=0; $data=fgets($f, $maxlen*5+$maxlenMes); $i++) // Читаем по 1 строке из файла, занося значения в переменную $data
  {     // просто считаем количество строк
  }
  fclose($f); // закроем файл по окончании чтения
if (@$i) {echo ' (всего '.@$i.')';} // если записей больше ноля, сообщим
} 
?>

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

comment.php

<? // Скрипт, который записывает данные формы и переадресовывает запрос
function check($str){ // функция проверки введеных данных
   $str=ereg_Replace("(<([^>])*>|>|<)","",$str); //Вытащить текст из тегов
   // Если вы хотите чтобы теги отображались (но ре работали как HTML-код),
   // а это может потребоваться, например, если сайт посвящен Веб-дизайну
   // и отзывы о статье могут содержать примеры HTML-кода), вместо удаления тегов,
   // следует применить две следующие строки (замена угловых скобок их кодами)
   // $str=str_replace("<",'&#060;',$str); //Заменить левую угловую скобку (символ 60) кодом
   // $str=str_replace(">",'&#062;',$str); //Заменить правую угловую скобку (символ 62) кодом
   
   $str=str_replace("|",'&#124;',$str); //Заменить вертикальную черту (символ 124) кодом, черта будет использоваться как разделитель полей
   $str=str_replace("`",'&#096;',$str); //Заменить оператор выполнения (символ 96) кодом 
   $str=str_replace("'",'&#039;',$str); //Заменить одинарные кавычки их кодами
   $str=str_replace('"','&quot;',$str); //Заменить двойные кавычки их кодами (теперь никакие кавычки не попадут в страницу)

   $str=str_replace("\r",'',$str); //Удаляем перевод каретки (иначе нарушится структура базы данных)
   $str=str_replace("\n",'<br>',$str); //Заменить начало строки HTML-кодом (иначе нарушится структура базы данных)
   return ($str);
}
if (@$warn) {unset($warn);} // если переменная определена, очистим ее
$filename = $DOCUMENT_ROOT.$_GET['htm'].'.csv'; // Занесем имя файла в переменную
require("setings.php") ; // здесь обработать как PHP
if (@$add) { // если нажата кнопка «добавить»
   if (empty($_POST['name']) or empty($_POST['mess'])) {// проверка наличия обязательных полей (именно в методе ПОСТ)
    $warn="Не заполнены обязательные поля!";
   }else{
    $warn=""; // тревожное сообщение пустое
    if(strlen($_POST['name']) > $maxlen) // проверка поля имени
    {
       $name=substr(check($_POST['name']),0,$maxlen);
       $warn="Слишком длинное имя. Сократите до $maxlen символов! ";
    }else{
       $name=check($_POST['name']);
    }
    if(strlen($_POST['mail']) > $maxlen) // проверка поля почты
    {
       $mail=substr(check($_POST['mail']),0,$maxlen);
       $warn="Слишком длинное имя. Сократите до $maxlen символов! ";
    }elseif($mail and ! eregi("([0-9a-z\.-_]+)@([0-9a-z\.-_]+)\.([a-z]{2,}) *$",$_POST['mail'])){
       $warn.="Таких электронных адресов не бывает! ";
    }else{
       $mail=check($_POST['mail']);
    }

    if(strlen($_POST['url']) > $maxlen) // проверка поля адреса
    {
       $url=substr(check($_POST['url']),0,$maxlen);
       $warn.="Слишком длинный адрес. Сократите до $maxlen символов!";
    }else{
       $url=check($_POST['url']);
    }
    if(strlen($_POST['city']) > $maxlen) // проверка поля города
    {
       $city=substr(check($_POST['city']),0,$maxlen);
       $warn.="Слишком длинное название города. Сократите до $maxlen символов!";
    }else{
    }
    if(strlen($_POST['mess']) > $maxlenMes) // проверка сообщения
    {
       $mess=substr(check($_POST['mess']),0,$maxlenMes);
       $warn.="Слишком длинное сообщение. Сократите до $maxlenMes символов!";
    }else{
       $mess=check($_POST['mess']);
    }
   }
   if (empty($warn)) { // если тревожных сообщений нет (все нормально)
    $f=fopen($filename,"a") or die("Не могу открыть файл на запись!");
    flock($f,LOCK_EX); // ждем, пока не станем единственными и блокируем
    fwrite($f, "$name|$mail|$url|$city|".time()."|$mess\r\n"); // записываем данные в файл, разделяя поля угловой скобкой
    fflush($f); // записываем все изменения на диск
    flock($f,LOCK_UN); // говорим что, больше не будем работать с файлом и разблокируем
    fclose($f); // Закрываем файл

    $f = fopen($filename,"r") or die("Ошибка открытия базы"); // Открываем файл еще раз
    for($i=0; $data=fgets($f, $maxlen*5+$maxlenMes); $i++) // Читаем по 1 строке из файла
    {
        @$totlines++ ;//сколько записей
    }
    fclose($f); // закроем файл
    $int=(int)($totlines/$maxlines); // вычисляем количество страниц,
    if ($int*$maxlines < $totlines):   // чтобы знать, на какой окажется добавленная запись
        $pages=$int+1; // переход на страницу произойдет только в случае удачного добавления
    else:		// иначе откроется страница, заданная методом GET формы (та, которая и была)
        $pages=$int;
    endif;

    Header("Location: http://".$_SERVER["SERVER_NAME"]. $_SERVER["SCRIPT_NAME"].'?adet=1&page='.$pages.'&htm='.@$htm); 
    exit(); // Заново запрашиваем страницу, указав имя коментируемого файла (параметр htm), номер страницы коментария (параметр page) и успешность добавления записи (установив параметр adet в единицу). Затем выходим из скрипта
   }
}
?>
<html><!-- Создаем оформление страницы  (эта часть работает если кнопка «добавить» не нажата или после ее нажатия добавить сообщение не удалось)-->
<head>
<meta http-equiv="content-type" content="text/html; charset=windows-1251">
<title>Комментарий к странице</title> <!--Запретим кеширование -->
<META http-equiv="Expires" content="Mon, 26 Jul 1997 05:00:00 GMT">
<META http-equiv="Cache-Control" content="no-cache, must-revalidate">
<META http-equiv="Pragma" content="no-cache">
<META http-equiv="Last-Modified" content="<?=gmdate("D, d M Y H:i:s");?>">
<META NAME="ROBOTS" CONTENT="noindex, nofollow"> <!--Запретим индексацию -->
<meta name="Description "content="">
<meta name="Keywords" content="">
<meta name="Author" content="Красносельский К. К.">
<style type="text/css">
.p {color:#222222; font-size:11px; font-family:Verdana, Tahoma}
</style>
</head>

<body>
<center>
<div>

<?
if (@$adet==1): // если добавлено сообщение
   echo "<P style='color:green'>Ваше сообщение добавлено</p>";
elseif (@$warn): // если сгенерировано тревожное сообщение
   echo "<P style='color:red'>$warn</p>";
else: // в остальных случаях
   echo "<P style='color:navy'>Оставьте Ваше сообщение</p>";
endif;
?>

<P>&nbsp;</p>

<!-- Скрипт, отображающий данные из файла -->
<?
function datestring($date){ // функция для формирования даты
    $monstring=array("января", "февраля", "марта", "апреля", "мая", "июня", "июля", "августа", "сентября", "октября", "ноября", "декабря");
    $m=$monstring[$date['mon']-1];

    $daystring=array("в воскресенье", "в понедельник", "во вторник", "в среду", "в четверг", "в пятницу", "в субботу");
    $d=$daystring[$date['wday']];

    if(strlen($date['minutes'])==1)
      { // добавим ноль перед числом, если оно меньше 10
      $min="0".$date['minutes'];
    }else{
      $min=$date['minutes'];
    }
    return "$d, ".$date['mday']." $m ".$date['year']." года, в ".$date['hours']." ч. $min мин.";
}

if (is_readable($filename)) { // если файл читается
  $f = fopen($filename,"r") or die("Ошибка открытия базы"); // Открываем файл и заносим его указатель в переменную
  for($i=0; $data=fgets($f, $maxlen*5+$maxlenMes); $i++) // Читаем по 1 строке из файла, занося значения в переменную $data
  {
     @$totlines++ ;// сколько записей
  }
  unset($i);
  fclose($f); // закроем файл по окончании чтения

  if (!isset($totlines)) {$totlines=0;}
  $int=(int)($totlines/$maxlines); // вычисляем количество страниц
  if ($int*$maxlines < $totlines):
    $pages=$int+1;
  else:
    $pages=$int;
  endif;
  if(@$page < 1 || @$page > $pages) {$page=1;} // текущая страница задается через GET. Если не задана, значит первая
  
  for ($link=1;$link<=$pages;$link++) // определяем ссылки на другие страницы
  {
    if ($link!=$page) // если ссылка не на текущую страницу
       {
       @$line.="<a href=".$_SERVER["SCRIPT_NAME"]."?page=$link&htm=$htm>[$link]</a>";
       }
    if ($link==$page) // если ссылка на текущую страницу
       {
       @$line.=" $link ";
       }
  }
  if (!isset($line)) {$line=1;}
  echo "<p>Записей $totlines,  Страницы  <b>$line</b>";

  // Запись строк
  $to=$page*$maxlines-$maxlines;// от
  $from=$page*$maxlines; // до
  if ($from > $totlines) {$from=$totlines;}

  $f = fopen($filename,"r") or die("Ошибка открытия базы"); // Открываем файл и заносим его указатель в переменную
  for($i=0; $i < $from; $i++) // от нуля до последней записи, которая должна отобразится
  {
     $data=fgetcsv($f, $maxlen*4+$maxlenMes, "|"); // Читаем по одной строке из файла, занося значения в переменную $data
     if ($i >= $to) // если номер записи больше или равен минимальному для страницы
     {
         list($nametext, $mailtext, $urltext, $citytext, $timetext, $messtext) = $data; // перебросим массив в переменные (можно было бы обращаться к элементам массива как $data[1], $data[2] и т. д., но удобней по именам)
    echo
  "
  <P>&nbsp;</p>
  <table border=1 width=90% cellpadding=2 cellspacing=1 bgcolor=#CCCCCC class=p>
  <tr><td align=center bgcolor=#e8e8ff><b>$nametext</b> ($citytext)</td></tr>
  <tr><td align=center bgcolor=#e8e8ff>E-mail: <i>$mailtext</i>, Home page: <i>$urltext</i></td></tr>
  <tr><td bgcolor=#FFFFFF>$messtext</td></tr>
  <tr><td align=right >Сообщение ".($i+1).", написано ".datestring(getdate($timetext))."</td></tr>
  </table>
  <P>&nbsp;</p>
  ";

    // добавим на страницу HTML-код, содержащий ячейки таблицы, со значениями из базы данных
     }
  }
  unset($i);
  fclose($f); // закроем файл по окончании чтения
}
?>
<!-- Создаем форму, определив, какие данные нас интересуют -->
<form action=<?echo $_SERVER["SCRIPT_NAME"]."?page=".@$pages."&htm=".@$htm;?> name="frm" method=post>
<table border=2 width=366px>
<tr><td align=right class=p>*Ваше имя:<input class=p type=text SIZE=39 MAXLENGTH=<?=@$maxlen;?> name=name value="<?=@$name;?>"></td></tr>
<tr><td align=right class=p>E-mail:<input class=p type=text SIZE=39 MAXLENGTH=<?=@$maxlen;?> name=mail value="<?=@$mail;?>"></td></tr>
<tr><td align=right class=p>Home Page:<input class=p type=text SIZE=39 MAXLENGTH=<?=@$maxlen;?> name=url value="<?=@$url;?>"></td></tr>
<tr><td align=right class=p>Город:<input class=p type=text SIZE=39 MAXLENGTH=<?=@$maxlen;?> name=city value="<?=@$city;?>"></td></tr>
<tr><td align=left class=p valign=top>*Сообщение (Не более <?=@$maxlenMes;?> символов):<br><textarea class=p name=mess rows=19 COLS=54><?=@$mess;?></textarea></td></tr>
<tr><td class=p colspan=2><input class=p type=submit value=Отправить name=add id=b> * – поля обязательные для заполнения.</td></tr>
</table>
</form>
<P>&nbsp;</p>
<?if (@$totlines) {echo "<p>Записей $totlines,  Страницы  <b>$line</b>";}?>
</div>
</center>
</body>
</html>

Скрипт может и не маленький, но для удобства посетителей, его можно усложнить еще, добавив проверку корректности ввода с помощью JavaScript. Для чего в форму добавляем:

onsubmit="return test()"

А в заголовочную часть страницы добавляем скрипт:

<SCRIPT LANGUAGE="JavaScript"><!--
function test()
{
 returnValue = false ;
if(document.frm.name.value=='') 
    alert('Укажите свое имя!');
else if (document.frm.mess.value=='') {
        alert('Отсутствует текст сообщения!');
 }else{
     returnValue = true ;
 }
 return returnValue ;
}//--></SCRIPT>

Комментарии к странице (всего 8)

На главную страницу сайта