Forum PHP.pl > Pager ( stronicowanie )

Pomoc - Szukaj - Użytkownicy - Kalendarz

Forum PHP.pl > Forum > Gotowe rozwiązania > Algorytmy, klasy, funkcje

Adrian Staniszewski

17.10.2006, 20:44:38

Witam,

Z potrzeby - bo to własnie ona jest matką wynalazków (a tak można nazwać ową klasę) - napisałem dla Siebie, swoich projektów prostą klasę do obsługi stronicowania. Przy projektowaniu skupiłem się głównie na tym aby generując nowy Pager mieć jak największą swobode przy generowaniu nowego pagera. Wszystkie parametry jakie uznałem za warte zastosowania można więc zmienic wywolujac klase. Przygotowalem ja tez dla kilku wywolan na stronie.

Klasa stylizowana jest na PHP5 - określenie iż jest napisana w PHP5 bym nie urzyl..

Jest to moja pierwsza publikowana klasa, kod nie jest opisany, ale z czasem poprawie zarówno klase jak i opisze ja zgodnie ze standardami.

Zapraszam do testowania :

[PHP] pobierz, plaintext 
<?
###############################################################
# Adrian Staniszewski
# adrian_s@toya.net.pl
# GG: 5513236
#
#	File:		  Class.Pager.php5
#	Version:	   1.3v.+
#	Modif:		 16.10.2006r. 16:30
#	Description:   Pager for www
#
##############################################################
 
class Pager {
 
  public $p_name;
  private $p = array();
  private $links = array();
 
  public function Pager($p_name='pager', $p_count='1', $p_per='250', $p_link='7', $p_sep=' ') {
	$this -> p_name = $p_name;
	$this -> setVar('count', $p_count);
	$this -> setVar('per', $p_per);
	$this -> setVar('html_link', '<a href="index.php?site={^link}" title="{^title}" style="text-decoration: none;">{^name}</a>n');
	$this -> setVar('sep', $p_sep);
	$this -> setVar('link', $p_link);
	$this -> setVar('site', '1');
	$this -> setVar('fast_link', '5');
  }
 
  private function getPages() {
	$this -> setVar('pages', ceil(($this -> getVar('count')/$this -> getVar('per'))));
  }
 
  private function setPages($page) {
	$this -> setVar('site', $page);
  }
 
  private function buildPager() {
 
	($this -> getVar('fast_link') >= '5' && $this -> getVar('pages') > '51' && $this -> getVar('site') > '50')?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') - 50), 'Wstecz o 50 stron', '<strong><||</strong>'):'';
	($this -> getVar('fast_link') >= '4' && $this -> getVar('pages') > '31' && $this -> getVar('site') > '30')?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') - 30), 'Wstecz o 30 stron', '<strong><<|</strong>'):'';
	($this -> getVar('fast_link') >= '3' && $this -> getVar('pages') > '11' && $this -> getVar('site') > '10')?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') - 10), 'Wstecz o 10 stron', '<strong><|</strong>'):'';
	($this -> getVar('fast_link') >= '2' && $this -> getVar('pages') > '6' && $this -> getVar('site') > '5')?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') - 5), 'Wstecz o 5 stron', '<strong><<</strong>'):'';
	($this -> getVar('fast_link') >= '1' && $this -> getVar('pages') > '1' && $this -> getVar('site') > '1')?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') - 1), 'Wstecz o strone', '<strong><</strong>'):'';
 
	$start = ($this -> getVar('site') - ceil($this -> getVar('link')/2));
	if($start <= '0') $start = '1';
 
	$koniec = ($this -> getVar('site') + ceil($this -> getVar('link')/2));
	if($koniec > $this -> getVar('pages')) $koniec = $this -> getVar('pages');
 
	for($i=$start; $i <= $koniec; $i++) {
		 ($i == $this -> getVar('site'))?$name = '<font size=+1>'.$i.'</font>':$name=$i;
	   $this -> links[$this -> p_name][] = $this -> createLink($i, $i, $name);
	}
	$this -> links[$this -> p_name][] = 'z <strong>'.$this -> getVar('pages').'</strong>';
	($this -> getVar('fast_link') >= '1' && $this -> getVar('pages') > $this -> getVar('site'))?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') + 1), 'Naprzód o strone', '<strong>></strong>'):'';
	($this -> getVar('fast_link') >= '2' && ($this -> getVar('site') + 5) <= $this -> getVar('pages'))?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') + 5), 'Naprzód o 5 stron', '<strong>>></strong>'):'';
	($this -> getVar('fast_link') >= '3' && ($this -> getVar('site') + 10) <= $this -> getVar('pages'))?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') + 10), 'Naprzód o 10 stron', '<strong>|></strong>'):'';
	($this -> getVar('fast_link') >= '4' && ($this -> getVar('site') + 30) <= $this -> getVar('pages'))?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') + 30), 'Naprzód o 30 stron', '<strong>|>></strong>'):'';
	($this -> getVar('fast_link') >= '5' && ($this -> getVar('site') + 50) <= $this -> getVar('pages'))?$this -> links[$this -> p_name][] = $this -> createLink(($this -> getVar('site') + 50), 'Naprzód o 50 stron', '<strong>||></strong>'):'';
  }
 
  private function createLink($link, $title, $name) {
	return preg_replace('/{^(.*?)}/sie', '$$1', $this -> getVar('html_link'));
  }
 
  public function Render() {
	$this -> getPages();
	$site = ($_GET['site']<>'' and is_numeric($_GET['site']))?''.$_GET['site'].'':'1';
	$this -> setPages($site);
	$this -> buildPager();
 
	foreach($this -> links[$this -> p_name] as $link) {
	  $html_out .= ''.$link.''.$this -> getVar('sep').'';
	}
	$this -> p[$this -> p_name]['html_out'] = $html_out;
	return $html_out;
  }
 
  public function startRecord() {
	return (($this -> getVar('site') - 1) * $this -> getVar('per'));
  }
 
  public function getVar($get) {
	return $this -> p[$this -> p_name][$get];
  }
 
  public function setVar($get, $var) {
	$this -> p[$this -> p_name][$get] = $var;
  }
 
  public function buildLink($link = 'index.php5', $delete = array('site')) {
 
	foreach($_GET as $pole => $war) {
	  $pole = trim($pole);
		if(!in_array($pole, $delete)) {
		  $a++;
		  ($a==1)?$zn='?':$zn='&';
		  $link .= ''.$zn.''.$pole.'='.$war.'';
		}
	}
return $link;
}
 
  public function setFastLink($leavel = '5') {
	if(is_numeric($leavel) && $leavel >= '0' && $leavel <= '5') {
	  $this -> setVar('fast_link', $leavel);
	}
  }
 
  public function setHTML_Link($html_link) {
	$this -> setVar('html_link', $html_link);
  }
 
}
?>
[PHP] pobierz, plaintext

Klase wywolujemy :

[PHP] pobierz, plaintext 
<?
include_once 'Class.Pager.php5';
 
// nazwa pagera || ilosc rekordow || ilosc wyswietlanych rekordow || ilosc wyswiet
lanych linkow do stron || oddzielanie linkow
$p = new Pager("nazwa_pagera", $num, "25");
// jesli mamy link posiadajacy parametry i chcemy je "przepisac" do naszego nowego linku do podstrony uzywamy builder'a linkow
$link = $p -> buildLink();
$link = "<a href="$link$pagess&site={^link}" title="{^title}" style="text-decoration: none;">{^name}</a>";
// funkcja ustawiajaca szablon linku
$p -> setHTML_Link($link);
// wywolanie - wyswietlenie pagera
echo $p -> Render();
 
?>
[PHP] pobierz, plaintext

NetJaro

17.10.2006, 21:11:11

Większych zastrzeżeń nie mam, ale tylko mała uwaga - z racji, że stronicowanie jest czasami dość ciężką "operacją" dla Apache - starałbym się jak najbardziej optymalizować skrypt który za to odpowiada - i dlatego wszystkie " " (cudzysłowia) zamieniłbym na ' ' (pojedyńcze apostrofy/cudzysłowia). Większa to szybkość wykonania kodu. Dodatkowo przy liczbach:

Cytat

$p = new Pager("nazwa_pagera", $num, "25");

Nie trzeba używać żadnych cudzysłowiów ;-)

I widzę stary nawyk z PHP4 - aby stworzyć konstruktor wystarczy nazwać funkcję __construct, a nie jak w PHP4 - tak jak nazwa klasy. Skoro klasa i tak nie pójdzie na PHP4 to po co używać jego części ;-)

Adrian Staniszewski

18.10.2006, 20:14:13

Witam,

poprawiłem kod klasy, zastapilem "" ''
mam nadzieje iz teraz zyskamy troszke wydajnosci

dodałem też nowa funkcje build_link(); - przyda sie wszystkim, ktorzy przekazuja w linku jakies parametry, np. wyszukiwania - domyslnie zbudowany link nie obsluguje mod_revrite

co do konstruktora.. moja funkcja Pager bedaca konstruktorem, jest takze funkcja tworzoca nowy Pager.. mozliwe iz myle sie ale uznalem iz lepiej zastosowac tutaj nazwe zwyczajawa funkcji zamiast __construct

jeżeli się myle to prosze o uwage na ten temat

Pozdrawiam

acztery

18.10.2006, 21:45:14

a ja mam pytanie. w funkcji build_link masz GLOBAL pomysl jak sie tego pozbyc.... nie stosuje sie juz global

Adrian Staniszewski

21.10.2006, 12:07:39

Wydanie wersji 1.3

Jest kilka istotnych zmian :
- ograniczyłem ilosc parametrow ustawianych w wywoalniu klasy (funkcja Pager)
- dodalem funkcje setFastLink(); - (opis w pierwszym poscie)
- poprawilem i zmienilem funkcje buildLink(); (usunalem GLOBAL)
- dodalem funkcje setHTML_Link(); zmieniajaca szablon linku HTML (mozna tutaj uzywac pomocniczo buildLink(); )
- dodałem ograniczenie wyswietlania "szybkich linkow"

Zapraszam do testowania i tworzenia projektow w oparciu o moj prosty Pager

p.s
przeprowadzilem badanie wydajnosci Pagera
wyniki sa oparte na 50 tys. wywolan, 100 tys. rekordow, 25 na strone

sredni czas generowania : 0,0025s

jezeli chcemy w kilku miejscach na stronie wyswietlic nasz raz wygenerowany pager uzywamy :

[PHP] pobierz, plaintext 
<?
 
echo $p -> getVar("html_out");
 
?>
[PHP] pobierz, plaintext

gdy na stronie mamy kilka Pagerow - rozrozniamy je po nazwie zadeklarowanej w wywolaniu klasy - wystarczy zmienic nazwe aktualnego Pagera poprzez:

[PHP] pobierz, plaintext 
<?
 
$p -> p_name = "nazwa_obecnego_pagera";
 
?>
[PHP] pobierz, plaintext

dodatkowo gdy pobieramy dane z bazy, skrypt latwo i szybko wygeneruje nam parametry pobierania:

[PHP] pobierz, plaintext 
<?
 
$start = $p -> startRecord();
$koniec = $p -> getVar("per");
 
?>
[PHP] pobierz, plaintext

Wszystkim szukajacym profesjonanego Pagera zapraszam do klasy nospora a lubiacym testowanie zapraszam do testowania

Pozdrawiam
Adrian Staniszewski

edit..

Funkcja buildLink();
wywolujemy ja po prostu :

[PHP] pobierz, plaintext 
<?
 
// w funkcji mozemy a raczej powinnismy zadeklarowac nazwe zmiennej GET w ktorej b
edziemy trzymac numer strony, aby skrypt usunal ja z tworzonego linku - mozemy tez podac inne zmienne ktore chcemy usunac z linku - calosc podajemy w formie tablicy
$link = $p -> buildLink();
 
// funkcja ta posiada 2 parametry - nazwa pliku (ew. sciezka do pliku) oraz wykluczenia (co ma zostac usuniete z linku)
 
$delete = array('site', 'kat', 'parent'); // wykluczenia
$link = $p -> buildLink('index.php', $delete);
 
?>
[PHP] pobierz, plaintext

w najnowszej wersji dodano tez funkcje setFastLink(); ustawia ona ile szybkich linkow ma zostac wygenerowanych w danym Pagerze - domyslnie jest to 5 na "strone" (+1, +5, +10, +30, +50, -1, -5, -10, -30, -50)

wartosc tego parametru to 0-5, a uzywamy go :

[PHP] pobierz, plaintext 
<?
 
// przed wywolaniem funkcji Render();
$p -> setFastLink('3');
 
?>
[PHP] pobierz, plaintext

Taifun

14.08.2007, 21:39:40

ta klasa jest prostsza od klasy, która jest ogólnie polecana początkującym (z tego forum)
a mianowicie jest lepsza od tego topora: http://forum.php.pl/index.php?showtopic=35...t=0&start=0

Adrian Staniszewski

15.12.2007, 00:18:59

miło mi to słyszec

będe musiał chyba pomyślec nad wgraniem nowej wersji i rozpisaniem dokumentacji dla innych

soon

3.03.2008, 09:29:13

przepraszam za pytanie, ale jak zrobić, żeby liczyło rekordy z bazy mysql?

Adrian Staniszewski

10.08.2010, 15:37:27

[PHP] pobierz, plaintext 
<?php
  $zapytanie = mysql)query("...") or die(mysql_error());
  $num = mysql_num_rows($zapytanie);
?>
[PHP] pobierz, plaintext

Witam,

Nie wiem skąd przeświadczenie o tym, iż skrypt można wykorzystywać komercyjnie bez mojej zgody..
Oświadczam, iż korzystanie ze skryptu w celach komercyjnych jest ZABRONIONE.

To jest wersja lo-fi głównej zawartości. Aby zobaczyć pełną wersję z większą zawartością, obrazkami i formatowaniem proszę kliknij tutaj.