Novices Design Courses » guest book

The guest book on PHP/MySQL

admin — Wed, 14 Oct 2009 06:57:06 +0000

Today I shall tell to you about how to write the guest book on PHP and MySQL. Anything complex{difficult} in it no, and opportunities given guest not the biggest: a paginal conclusion of recordings, check of the entered data, an opportunity to delete recording.

We admit{allow}, that at you already is PHP, MySQL and the web – server. All of you have established and have adjusted.

Let’s start with creation of the table in which the data of our guest book will be stored{kept}. We shall ask the user a name and the comment. At desire the user can inform e-mail addresses and a homepage. For administration of the book we need one more field, unique for each recording, – the identifier. Well and date, certainly. In a result such table turns out:

CREATE TABLE gb (

id int (10) unsigned NOT NULL auto_increment,

datetime datetime DEFAULT ‘ 0000-00-00 00:00:00 ‘ NOT NULL,

name varchar (100) NOT NULL,

email varchar (100),

www varchar (100),

message text NOT NULL,

PRIMARY KEY (id)

);

The table at us is. Now it is possible to start programming.

For we shall create a file with adjustments of the guest book:

// The general{common} constants

define (‘PATH’, ‘/gb / ‘); // a way to the guest book

define (‘ RECSPERPAGE ‘, 10); // quantity{amount} of recordings on one page

define (‘ ADMIN_EMAIL ‘,’ artem@sapegin.ru ‘); // email the manager

define (‘ ERROR_LOG_FILE ‘,’ logs/error.log ‘); // a file of a broad gully of mistakes

// Parameters of a DB

define (‘ DBHOST ‘,’ localhost ‘); // the host name

define (‘ DBUSER ‘,’ root ‘); // a login name

define (‘ DBPASSWD ‘, “); // the password

define (‘ DBNAME ‘,’ test ‘); // a name of a database

Now we shall think, what auxiliary functions will be necessary for us. On it will be necessary to cooperate with SUBD, will check up and to process the data entered by the user. As for functions of administration on it is required to distinguish the manager from simple users.

Let’s start with job with SUBD.

/ ** recource db_connect (string host, string user, string passwd, string dbname)

* Connection to SUBD and opening of a database

function db_connect ($host, $user, $passwd, $dbname)

{

$link = mysql_pconnect ($host, $user, $passwd) or die (‘ Could not connect to database ‘);

mysql_select_db ($dbname) or die (‘ Could not select database ‘);

return $link;

}

/ ** Carries out search to a DB

* @param the text of search

* @return resource id

function db_query ($query)

{

$result = mysql_query ($query)

or die (‘ Bad database query ‘);

return $result;

}

/ ** Carries out search to a DB (placeholder)

* @param the text of search

* @param*

* @return resource id

function db_query_ex ($query)

{

$values = func_get_args ();

array_shift ($values);

$i = 0;

return db_query (preg_replace (‘ %? %e ‘,’ “‘” .addslashes ($values [$i ++]). “‘” ‘,

$query));

}

Processing of lines (check and kill of the data entered by the user).

/ **

* Whether checks is the line e-mail address

function strings_isemail ($string)

{

return preg_match (‘ % [-.w] + [-w] + (?:. [-w] +) + % ‘, $string);

}

/ **

* Addition of links on http and e-mail

function strings_addlinks ($string)

{

return preg_replace (

‘ % ((?:http|ftp): // [-w] + (?:. [-w] +) +b [-w: and? = +! / ~ * $. ' %] *) (?

‘ \1 ‘,

$string

);

}

/ **

* Cleaning a line

function strings_clear ($string)

{

$string = trim ($string);

$string = stripslashes ($string);

return htmlspecialchars ($string, ENT_QUOTES);

}

/ **

* Trimming a line

function strings_stripstring ($text, $wrap, $length)

{

$text = preg_replace (‘ % (S {‘. $ wrap. ‘}) % ‘, ‘\1, $text);

return substr ($text, 0, $length);

}

autentifikacii the manager I leave a spelling to you as the domestic task. There are many ways and their discussion – a subject of separate clause{article}. I shall result only function – zaglushku:

/ **

* Check: the manager or the usual user

function auth_is_admin ()

{

return $ _GET [' admin '];

}

Further goes enough the big module which contains almost all HTML-code of the guest book, – a pattern. In him there is nothing complex{difficult} and his{its} spelling is possible quite under force verstal`hhiku a site if at you those is present.

/ **

* Heading of page

function template_header ($page)

{

page <? = $page?> <fjGuestbook Demo

fjGuestbook Demo

}

/ **

* The termination{ending} of page

function template_footer ()

{

Artem Sapegin

}

/ **

* The form of addition of new recording

function template_form ($name, $email, $www, $message, $error)

{

// A conclusion of the message on a mistake

function error ($error)

{

if ($error) echo ‘
‘. $ error.

‘ ‘;

}

echo ‘

To add the new message

the Name * :	maxlength=100 value = ” ‘. $ name. ‘ “> ‘; @error ($error [' name ']); echo ‘
Email:	maxlength=100 value = ” ‘. $ email. ‘ “> ‘; @error ($error [' email ']); echo ‘
URL:	maxlength=100 value = ” ‘. $ www. ‘ “> ‘; echo ‘
the Message * :	<p>name = “message”> ‘. $ message. ‘ ‘; @error ($error [' message ']); echo ‘
	* - Obligatory fields
	value = ” To add the message “>

‘;

}

/ **

* A seal of one recording the guest book

function template_show_body ($id, $name, $email, $www, $message, $datetime)

{

$out = ‘

‘. $ name. ‘ ‘;

// If is email or homepage – it is printed them

if ($email || $www)

{

$out. = ‘ (‘;

if ($email)

$out. = ‘ email ‘;

if ($email ** $www)

$out. = ‘ | ‘;

if ($www)

$out. = ‘ www ‘;

$out. = ‘) ‘;

}

$out. = ‘ writes ‘. $ datetime. ‘:

‘. $ message. ‘

‘;

// If the guest book is looked through by the manager – print the button

// Removals{Distances} of recording

if (auth_is_admin ())

{

$out. = ‘

[

'> to remove ]

‘;

}

return $out;

}

And, we at last have reached the main thing. Up to the module of the guest book. I shall try to write more comments that to you it was understandable.

/ **

* Creation of the table if she{it} still no

function gb_install ()

{

db_query (

‘ CREATE TABLE IF NOT EXISTS gb (

id int (10) unsigned NOT NULL auto_increment,

datetime datetime NOT NULL default ‘ 0000-00-00 00:00:00 ‘,

name varchar (100) NOT NULL default “,

email varchar (100) default NULL,

www varchar (100) default NULL,

message text NOT NULL,

PRIMARY KEY (id),

INDEX (datetime)

) TYPE=MyISAM; ‘

);

}

/ **

* Addition of recording in the guest book

function gb_add ($name, $email, $www, $message, and $error)

{

// We check correctness of filling of fields

$error = “;

if (empty ($name))

$error [' name '] = ‘ This obligatory field ‘;

if (empty ($message))

$error [' message '] = ‘ This obligatory field ‘;

if (! empty ($email) **! strings_isemail ($email))

$error [' email '] = ‘ It not email ‘;

// If not was mistakes – it is added

if (! $error)

{

// We clean the data

$name = strings_clear ($name);

$message = strings_clear ($message);

$name = strings_stripstring ($name, 15, 100);

$email = strings_stripstring ($email, 100, 100);

$www = strings_stripstring ($www, 100, 100);

$message = strings_stripstring ($message, 100, 2000);

$message = nl2br ($message);

// If the user was too lazy to write http:// before the address – we shall make

// It for him{it}

if (! empty ($www) ** ‘ http:// ‘! = substr ($www, 0, 7))

$www = ‘ http: // ‘. $ www;

// Search about addition of recording in a database

db_query_ex (‘ INSERT INTO gb (name, email, www, message, datetime)

VALUES (????, NOW ()) ‘, $name, $email, $www, $message);

// We throw a browser on the first page

// It is necessary, that if the user will press button Refresh,

// Recording was not added once again

header (‘ Location: ‘.PATH. “? page=1 “);

}

// Removal{Distance} of recording from the guest book

function gb_delete ($id)

{

// Search about removal{distance} of recording from a database

// WHERE id = ‘. $ id specifies recording which should be removed

db_query_ex (‘ DELETE FROM gb WHERE id =? ‘, $id);

header (‘ Location: ‘.PATH. “? page=1 “); //???

}

// A conclusion of page with recordings

function gb_show ($page)

{

// Position of the first recording page

$begin = ($page – 1) * 10;

// Sample of recordings of a database

// SELECT * FROM gb – all fields from bd gb

// ORDER BY datetime DESC – sorting by date of, new from above

// LIMIT ‘. $ begin. ‘, ‘.RECSPERPAGE – restriction:

// RECSPERPAGE (see defines.php) recordings since $begin

$result = db_query (‘ SELECT * FROM gb ORDER BY datetime DESC LIMIT ‘.

$begin. ‘, ‘.RECSPERPAGE);

$out = “;

// A cycle on all chosen recordings

while ($row = mysql_fetch_array ($result))

$out. = template_show_body ($row [' id '], $row [' name '], $row [' email '],

$row [' www '], $row [' message '], $row [' datetime ']);

// We destroy result

mysql_free_result ($result);

echo $out;

}

// A conclusion of the list of pages

function gb_showpages ($current)

{

// We learn{We find out} number of recordings in the guest book

$result = db_query (‘ SELECT * FROM gb ‘);

$rows = mysql_num_rows ($result);

if ($rows)

{

$pages = ceil ($rows / RECSPERPAGE);

// We print links to pages (number{room} of the current page is not the link)

echo ‘

‘;

for ($i = 1; $i <= $pages; $i ++)

{

if ($i! = $current)

echo ‘ | ’. $ i. ‘ ‘;

else

echo ‘ | ‘. $ i;

}

echo ‘ | ‘;

// If it not polslednjaja page we print the link “Further”

if ($current <$pages)

echo ‘> a href = ‘.PATH. ‘? page = ‘. ($ current + 1).

‘> is Farther>> ‘;

echo ‘

‘;

}

And the last – it is united all together.

/ **

* fjGuestbook 1.2

* A nucleus of the guest book

* http://sapegin.ru

// We connect modules

require_once ‘ my/defines.php ‘;

require_once ‘ my/template.php ‘;

require_once ‘ engine/lib/strings.php ‘;

require_once ‘ engine/lib/auth.php ‘;

require_once ‘ engine/lib/bd.php ‘;

require_once ‘ engine/gb.php ‘;

// We are connected to a DB

db_connect (DBHOST, DBUSER, DBPASSWD, DBNAME);

// We create the table if she{it} no

gb_install ();

// We obtain the given forms if the form has been sent

if (! empty ($ _POST [' sb ']))

{

$name = $ _POST [' name '];

$email = $ _POST [' email '];

$www = $ _POST [' www '];

$message = $ _POST [' message '];

$formerr = “;

}

else

{

$name = $email = $www = $message = $formerr = “;

}

// If number{room} of page is not specified in GET-search, we deduce{remove} the first

if (is_numeric ($ _GET [' page ']))

$page = $ _GET [' page '];

else

$page = 1;

// If it is necessary to add recording, we add

if ($ _GET [' add '])

gb_add ($name, $email, $www, $message, $formerr);

// If it is necessary to remove recording, we delete

if (isset ($ _GET [' del ']) ** auth_is_admin ())

gb_delete (intval ($ _GET [' del ']));

// We print the guest book

template_header ($page);

gb_showpages ($page);

gb_show ($page);

gb_showpages ($page);

template_form ($name, $email, $www, $message, $formerr);

template_footer ();

The guest book step by step

admin — Wed, 14 Oct 2009 06:56:15 +0000

In this clause{article} we shall learn to create the guest book on PHP. And though this clause{article} is written for newbies, but you should possess even elements of programming on PHP.

So, for the beginning let’s be defined{determined}, that we shall write. In a result we should receive the guest book with the following properties:

* The visitor necessarily should enter the name and the message, and at will the e-mail and the address of a homepage.

* Splitting into pages.

* Our guest book should work with register_globals = Off.

* All recordings are stored{kept} in a usual text file (i.e. we will not need a database).

* The guest book will consist of one file.

The note. All below-mentioned have been tested on PHP 4.3.0.

With problems{tasks} like were defined{determined}, now let’s understand as at us all will be vygdjadet`. The form and recordings will be is deduced on one page. Our file will be called gb.php. We shall write a code of the form. At me it has turned out that:

Now we shall understand with the basic adjustments of our guest book:

//———-Adjustments GB———-//

$file_gb = “c:/HTTP/CoderPRO/site/gb.dat”; // a file where recordings GB are stored{kept}

$max_rec = 128; // a maximum quantity of recordings in a file

$rec_page = 6; // quantity{amount} of recordings deduced{removed} on one page

//———————————-//

Let’s write a code of heading of our page:

:: the Guest book::..

the Guest book

Lines with META are necessary that our page not kehshirovalas`. The first line speaks a browser, that page kehshirovat` it is not necessary, and the second – if a browser does not understand the first parameter Pragma, that a storage time of our page in a cache – 0 sek.

Now we shall start actually programming. For the beginning we shall write function of check of the entered data:

// Check of the entered data //

function test () {

global $HTTP_POST_VARS;

if (! isset ($HTTP_POST_VARS [' msg_from '], $HTTP_POST_VARS [' msg_mail '],

$HTTP_POST_VARS [' msg_url '], $HTTP_POST_VARS [' msg_message '])) {

echo ”

the Mistake at transfer of parameters to a script!

Address to the manager of a site.

n “;

return (false);

}

if (trim ($HTTP_POST_VARS [' msg_from ']) == ” “) {

echo ”

you have not entered the name. Repeat input.

n “;

return (false);

}

if (trim ($HTTP_POST_VARS [' msg_message ']) == ” “) {

echo ”

you have not entered the message. Repeat input.

n “;

return (false);

}

return (true);

} // test ()

$HTTP_POST_VARS is a file containing all keys and values transferred{handed} by method POST (works at register_globals = Off). Whether all over again in function all is checked was transferred{handed}, and then whether obligatory fields the Name and the Message have been filled. Certainly, it is possible to make still check on a correctness entered e-mail and url and much that else, but it already if would be desirable you, do{make}, and we shall not be on it zamorachivat`sja and we shall go further.

Let’s consider as at us will be it is stored{kept} recordings in a file. In one line of a file – one recording in the following format:

Imja|E-Mail|URL|Data And time dobavlenija|Soobhhenie

Before addition of recording we should a little podredaktirovat` the data. As it is possible to notice, for division of parts of recording we use a sign |, means our data should not contain this sign – we shall replace it{him} with analogue in a html-code: *brvbar;. Further we should check up length of the message, and if she more than some size (for example more than 1000 symbols) to cut off the message till the necessary length. Then we convert all special symbols in mnemonic HTML (function htmlspecialchars). And at last, we shall replace all carries of lines to the message on
and we shall format the data in the format necessary to us for recording in a file. Certainly here again it is possible to make still a heap of everyones pribambasov, but it we shall leave for independent jobs and we shall do{make} our guestbook further. So for recording in a file we have generated a line and now she{it} should be added in a file, thus not privysiv a limit of quantity{amount} of recordings in a file (recollect adjustments of our page: $max_rec = 128;) . I write something much, and a code it is not visible: to you our function of addition of recording in a file:

// Function of addition of recording //

function add () {

global $max_rec;

global $file_gb;

global $HTTP_POST_VARS;

$recs = @file ($file_gb) or $recs = array ();

$from = $HTTP_POST_VARS [' msg_from '];

$mail = $HTTP_POST_VARS [' msg_mail '];

$url = $HTTP_POST_VARS [' msg_url '];

$message = $HTTP_POST_VARS [' msg_message '];

$from = str_replace (“|”, ” *brvbar; “, $from);

$mail = str_replace (“|”, ” *brvbar; “, $mail);

$url = str_replace (“|”, ” *brvbar; “, $url);

if (strlen ($message)> 1000) $message=substr ($message, 0,1000);

$message = htmlspecialchars ($message, ENT_QUOTES);

$message = str_replace (“|”, ” *brvbar; “, $message);

$message = trim ($message);

$message = ereg_replace (”

“,”
“, $message);

array_unshift ($recs, ” $from | $ mail | $ url | “.date (” d M Y, H:i “). ” | $messagen “);

if (count ($recs)> $max_rec) $recs=array_slice ($recs, 0, $max_rec);

$count = count ($recs);

$f = fopen ($file_gb, “w”);

for ($i=0; $i <$count; $i ++) {

fwrite ($f, $recs [$i]);

}

fclose ($f);

} // add ()

$recs is a file with recordings. If the file $file_gb exists, with the help of function file () we appropriate{give} each line of a file to one element of a file, in an opposite case $recs – an empty file. Further there is an editing the data described above. Then with the help of function array_unshift () we add in the beginning of recordings our recording. Check on quantity{amount} of recordings further follows, and if quantity{amount} more necessary, with the help of function array_slice () we select the first elements in the quantity{amount} necessary to us. Well and, at last, we write down our recordings in a file.

So, for addition of recordings we have made functions, now it is necessary to make function for a paginal conclusion of the data to the screen. Basically in a conclusion of the data anything complex{difficult} no, counted recording – have deduced{removed} according to design and everything, but in fact we want to draw a conclusion paginal – in it just and there can be a complexity. So we shall start: First I shall result a code of function view (), and then we shall disassemble it{him}.

// Function of a conclusion of recordings //

function view () {

global $file_gb;

global $HTTP_GET_VARS;

global $rec_page;

if (file_exists ($file_gb)) {

$messages = file ($file_gb);

$count = count ($messages);

if ($count> $rec_page) {

nav_page (ceil ($count / $ rec_page), (isset ($HTTP_GET_VARS [' page '])?

$HTTP_GET_VARS [' page ']: 1), ” gb.php? page = “);

echo “
”;

}

$num_page=1;

if (isset ($HTTP_GET_VARS [' page '])) {

if (($HTTP_GET_VARS [' page ']> 0) and

($HTTP_GET_VARS [' page '] <=ceil ($count / $ rec_page)))

$num_page = $ HTTP_GET_VARS [' page '];

}

for ($i = ($ num_page-1) * $rec_page; $i <= (($num_page * $ rec_page <$count)?

$num_page * $ rec_page-1: $count-1); $i ++) {

$tmp = explode (“|”, $messages [$i]);

echo ”

n “;

echo ”

n “;

echo ”

n “;

echo ”

n n “;

echo ”

n n

n “;

echo ” From:
“;

if ($tmp [2] <> ” “) echo ” URL:
“;

echo ” Date: n “;

echo ”

n “;

echo $tmp [0];

if ($tmp [1] <> ” “) {echo ” | “. $tmp [1.] ” “;}

echo “
”;

if ($tmp [2] <> ” “) echo ” “. $tmp [2.] ”
“;

echo $tmp [3.] “n”;

echo ”

n “;

echo $tmp [4];

echo ”

n “;

echo “
”;

} // for

if ($count> $rec_page) {nav_page (ceil ($count / $ rec_page),

(isset ($HTTP_GET_VARS [' page '])? $HTTP_GET_VARS [' page ']: 1), ” gb.php? page = “);}

echo “
”;

} else {

echo ”

Recordings no. You can be the first;)
n “;

}

} // view ()

Global variables: $file_gb – a file with recordings, $rec_page – deduced{removed} on one page – these variables we have defined{determined} quantity{amount} of recordings right at the beginning in adjustments of our guest book. And $HTTP_GET_VARS is a file containing all keys and values transferred{handed} by method GET, i.e. through URL (works at register_globals = Off) is to us it is required, since we shall just pass number{room} of page through URL. We shall understand, that our function does{makes}. First check is carried out – whether there is a file with recordings – and if is job on a conclusion of recordings and if there is no file the message is deduced is carried out, that recordings no. So, if it’s OK and we have file with recordings with the help of function file () we create a file of lines of a file $messages, and a variable $count appropriate{give} kol-in elements of the received file, i.e. quantity{amount} of recordings. Further goes the conclusion of navigation of pages and recordings is carried out according to the necessary page. In particular we use function nav_page, I shall result only its{her} code.

// Function of a conclusion of navigation on pages //

function nav_page (

$count, // the General{Common} kol-in pages

$num_page, // Number{Room} of the current page

$url // What URL for the link to page

// (to it{him} number{room} of page) is added

) {

$page_nav = 3; // how much pages to deduce{remove} simultaneously

$begin_loop=1; // initial value in a cycle

$end_loop = $ count; // final value in a cycle

echo ”

[Pages ($count): ";

// Check on a correctness of number{room} of the current page

if ($num_page> $count or $num_page <1) $num_page=1;

// Further in function there is a conclusion of navigation, all is received here by practical consideration

if ($num_page> $page_nav) {

echo "

($num_page % $ page_nav == 0? 1 : 0))). " "> (". ($page_nav * (floor ($num_page / $ page_nav)-

1-($ num_page % $ page_nav == 0? 1 : 0)) +1). "-". ($page_nav * (floor ($num_page / $ page_nav)-

($num_page % $ page_nav == 0? 1 : 0))). ") ";

$begin_loop = $ page_nav * (floor ($num_page / $ page_nav) - ($num_page % $ page_nav == 0? 1 : 0)) +1;

}

if ($count> $page_nav * (floor ($num_page / $ page_nav) - ($num_page % $ page_nav == 0? 1 : 0) +1)) {

$end_loop = $ page_nav*ceil ($num_page / $ page_nav);

}

for ($i = $begin_loop; $i <= $end_loop; $i ++) {

if ($i == $num_page) echo " *nbsp; $i ";

else echo " *nbsp; $i ";

} // for

if ($count> $page_nav * (floor ($num_page / $ page_nav) - ($num_page % $ page_nav == 0? 1 : 0) +1)) {

echo " *nbsp; *nbsp;...

" "> (". ($page_nav*ceil ($num_page / $ page_nav) + 1);

if ($page_nav*ceil ($num_page / $ page_nav) +1 <$count) {

echo "-". ($count <= $page_nav * (ceil ($num_page / $ page_nav) +1)?

$count: $page_nav * (ceil ($num_page / $ page_nav) +1));

}

echo ") ";

}

echo " *nbsp; *nbsp;]

n “;

} // nav_page ()

I shall not describe this piece, you can read about it in my clause{article} a paginal conclusion where all this is in detail described. Here I shall describe only how we deduce{remove} recordings. We have a cycle in which initial and final value $i – changes depending on page which we want to display. In a cycle we from an element of a file $messages [$i] create a file $tmp with the help of function explode which breaks a line into lines on borders formed{educated} by a separator |. I.e. we receive a file in which 0-th element – the Name, 1-st – e-mail, 2-nd – url, 3-rd – date and time of addition, 4-th – the message. Well and further we deduce{remove} our recording as we want.

We also have written all necessary functions for the guest book, remained only will write a code which to be carried out in the beginning, i.e. will choose, what function to start. He:

if (isset ($HTTP_POST_VARS [' msg_submit '])) {if (test ()) add ();}

view ();

I think anything complex{difficult} in him there are no also you will understand that where:)

All! We have written everything, that is necessary! Now collect all in a heap and receive the high-grade guest book. To collect in the following order: 1) Heading of a file, 2) Adjustments GB, 3) Functions, 4) our last written line, 5) the Form for addition, 6) a page header.

To whom laziness all to collect – can download available. See a file gb.zip.

Let’s sum up: we have written the high-grade guest book and all problems{tasks} which have put before itself have carried out. Certainly it is possible to make still a heap of any chesspieces, to write administration of the guest book and many other things, but it already a subject of other clause{article}. In general, I hope clause{article} to you it was useful. If something was not understandable, favour I ask: write on a soap – I shall necessarily answer.