Tag Archives: php

webmastering

MySQL, PDO i procedury składowane

Trochę nie pisa­łem. Mam nadzieję, że dzisiej­szy wpis wszyst­kim wyna­gro­dzi moją nieobec­ność. Ostat­nio staną­łem przed wyzwa­niem zrobie­nia gale­rii zdjęć, których kolej­ność dałoby się dowol­nie mody­fi­ko­wać za pomocą prze­cią­ga­nia i upusz­cza­nia. Dzisiaj opiszę opera­cje bazo­da­nowe, a na następny raz jQuery. Będę maksy­mal­nie uprasz­czał aby nie zaciem­niać meritum.

1. Przy­go­to­wa­nia

Powiedzmy, że mamy 2 tabele rela­cyjne odpo­wie­dzialne za prze­cho­wy­wa­nie gale­rii i obra­zów. Np. takie:

CREATE TABLE `galleries` (
  `id` INT(10) UNSIGNED NOT NULL AUTO_INCREMENT,
  `created` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `updated` TIMESTAMP NOT NULL DEFAULT '0000-00-00 00:00:00',
  `title` VARCHAR(250) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB  DEFAULT CHARSET=utf8 ;
 
CREATE TABLE IF NOT EXISTS `images` (
  `id` INT(10) UNSIGNED NOT NULL AUTO_INCREMENT,
  `gallery_id` INT(10) UNSIGNED NOT NULL,
  `filename` VARCHAR(50) NOT NULL,
  `ordr` INT(10) UNSIGNED NOT NULL DEFAULT '1',
  `created` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  KEY `image_to_gallery` (`gallery_id`)
) ENGINE=InnoDB  DEFAULT CHARSET=utf8 ;

Od razu widać dwa dziwac­twa: dlaczego pole nazywa się ordr a nie order? Z czystego leni­stwa. Order jest słowem zare­zer­wo­wa­nym w SQL (ORDER BY coś tam). Każdo­ra­zowo nazwa pola musia­łaby być w nawia­sach. Dlaczego pole upda­ted ma domyślną wartość 0000−00−00 00:00:00? Ano dlatego, że CURRENT_TIMESTAMP można użyć tylko raz w tabeli. Wobec tego stwo­rzymy od razu wyzwa­lacz (trig­ger), który przed każdym zapy­ta­niem typu UPDATE poprawi wartość na taką jak trzeba.

DELIMITER $$
CREATE TRIGGER `updated_current_timestamp` BEFORE UPDATE ON `galleries`
   FOR EACH ROW BEGIN
      SET NEW.updated = NOW();
END$$

Na koniec trzeba stwo­rzyć rela­cję 1 gale­ria do wielu zdjęć.

ALTER TABLE `images`
   ADD CONSTRAINT `image_to_gallery` FOREIGN KEY (`gallery_id`) REFERENCES `galleries` (`id`) ON DELETE CASCADE ON UPDATE CASCADE;

Ozna­cza to, że kasu­jąc gale­rię od razu pozbę­dziemy się również wszyst­kich powią­za­nych z nią zdjęć. Pliki z dysku oczy­wi­ście nie znikną. Można napi­sać funk­cję, która przed usunię­ciem gale­rii z bazy najpierw wyrzuca wszyst­kie powią­zane z nią pliki, a dopiero potem wyko­nuje pole­ce­nie DELETE.

2. Decy­zje

Teraz nadszedł czas na poważne decy­zje. Chodzi o sposób mani­pu­la­cji wier­szami doty­czą­cymi zdjęć. Można to zrobić za pomocą PHP. Jest to rozwią­za­nie prost­sze. Powo­duje jednak spory narzut komu­ni­ka­cji PHP<—>SQL. W przy­padku zwale­nia wszyst­kiego na bazę danych, pchamy logikę wyżej i bliżej mody­fi­ko­wa­nych danych. Minu­sem jest cholerna skład­nia SQLowa i później­sze proble­ma­tyczne utrzy­ma­nie kodu.
Problem oczy­wi­ście nie istnieje gdy robimy gale­ryjkę na 10 obraz­ków i prze­sta­wimy sobie kolej­ność ostat­niego na przed­ostatni. Ja raczej podcho­dzę do rzeczy poważ­nie i wolę od początku zrobić to tak jak powinno być. Poza tym wyzwa­la­cze i proce­dury skła­do­wane to jest to, co bazo­da­nowe tygry­ski lubią najbardziej :-)

3. Wyko­na­nie

Każdy nowy rekord tabeli images musi mieć nadany odpo­wiedni iden­ty­fi­ka­tor pozy­cji ordr o 1 więk­szy od ostat­niego w danej gale­rii. Mamy trzy rozwią­za­nia: czysty PHP, wyzwa­lacz wywo­ły­wany przed INSERTem lub proce­dura skła­do­wana. Zapy­ta­nie w PHP może wyglą­dać tak:

$q = $pdo->prepare('INSERT INTO images (filename,gallery_id,ordr) (SELECT ?,?,MAX(ordr)+1 FROM images WHERE gallery_id=? LIMIT 1)');
$q->bindValue(1, 'obrazek.jpg', PDO::PARAM_STR);
$q->bindParam(2, $galleryId, PDO::PARAM_INT);
$q->bindParam(3, $galleryId, PDO::PARAM_INT);
$q->execute();

Wspo­mi­nam o tym rozwią­za­niu dlatego, że ma ciekawą konstruk­cję INSERT SELECT. Zapewne więk­szość z was po kilku­na­sto­krot­nej próbie wywo­ła­nia pole­ce­nia INSERT INTO VALUES i gdzieś tam SELECT dosta­nie cholery i rozbije zapy­ta­nie na 2: pierw­sze spraw­dza ostatni ordr, a następne doda 1 i umie­ści INSERTem pozo­stałe dane.
Bazo­da­nowe tygry­ski wybiorą jednak co innego. Proce­dury składowane!

DELIMITER $$
CREATE PROCEDURE `insert_image`(IN image_filename VARCHAR(50), IN image_gallery_id INT, OUT last_inserted_id INT)
   MODIFIES SQL DATA
   COMMENT 'Inserts new image at the end of given gallery.'
   BEGIN
      DECLARE max_order INT;
 
      # Zamiast SET zmienna= uzywam SELECT INTO just FOR fun
      SELECT MAX(ordr) INTO max_order FROM images WHERE gallery_id=image_gallery_id LIMIT 1;
 
      # Gdy obrazek jest pierwszy w galerii
      IF max_order IS NULL THEN 
         SET max_order = 1;
      ELSE
         SET max_order = max_order + 1;
      END IF;
      INSERT INTO images (filename, gallery_id, ordr) VALUES (image_filename, image_gallery_id, max_order);
      SELECT LAST_INSERT_ID() INTO last_inserted_id;
END$$

Próba wywo­ła­nia $pdo->lastInsertId() zakoń­czy się niepo­wo­dze­niem (a raczej zerem :-) ). Dlatego potrze­bu­jemy para­me­tru wyjścio­wego. Poni­żej poka­zuję jak całość wywo­łać w PDO:

$q = $pdo->prepare('CALL insert_image(?,?,@lastInsertId)');
$q->bindValue(1, 'obrazek.jpg', PDO::PARAM_STR);
$q->bindParam(2, $galleryId, PDO::PARAM_INT);
$q->execute();
$outputArray = $pdo->query('select @lastInsertId')->fetch(PDO::FETCH_ASSOC);
$lastInsertId = $outputArray['@lastInsertId'];

Ktoś może się zapy­tać po co te numery ze zmienną wyjściową. PDO i sterow­nik MySQL w PHP ma szpetny błąd doty­czący obsługi para­me­trów wyjścio­wych z proce­dur skła­do­wa­nych. Podobno w nowszych wersjach jest OK. Trik podany wyżej u mnie działa i oszczę­dza trochę nerwów.

Proce­dura kasu­jąca obrazki również jest raczej prosta. Rzuć­cie okiem:

DELIMITER $$
CREATE PROCEDURE `delete_image`(IN image_id INT)
   MODIFIES SQL DATA
   COMMENT 'Deletes and reorders if there is a gap.'
   BEGIN
      DECLARE image_gallery_id, image_order, max_order INT;
      SELECT gallery_id, ordr INTO image_gallery_id, image_order FROM images WHERE id=image_id LIMIT 1;
      DELETE FROM images WHERE id=image_id LIMIT 1;
      SELECT MAX(ordr) INTO max_order FROM images WHERE gallery_id=image_gallery_id LIMIT 1;
 
      # Sprawdzamy czy istnieja jakies obrazki za skasowanym
      IF max_order IS NOT NULL AND max_order > image_order THEN
         WHILE image_order < max_order DO
 
            # Cofamy w petli wypelniajac luke po skasowanym obrazku
            UPDATE images SET ordr=image_order WHERE ordr=image_order+1 AND gallery_id=image_gallery_id;
            SET image_order = image_order + 1;
       END WHILE;
   END IF;
END$$

Wywo­ła­nie jest super proste. Wpisu­jemy i zapominamy:

$q = $pdo->prepare('CALL delete_image(?)');
$q->bindParam(1, $imageId, PDO::PARAM_INT);
$q->execute();

Najlep­sze zosta­wi­łem na koniec. Proce­dura prze­sta­wia­jąca pozy­cję obrazka. Spotka­łem się w necie z rozwią­za­niem typu „bierzesz sobie wszyst­kie id obraz­ków w kolej­no­ści, prze­jeż­dżasz fore­achem, który nadaje kolej­ność i na każdym obrazku wyko­nu­jesz update”. No dobra, ale co jeżeli prze­sta­wiam kolej­ność tylko ostat­niego i przed­ostat­niego, a w gale­rii mam 1000 zdjęć? Powyż­sze rozwią­za­nie orze całą gale­rię, a userzy czekają 5 sek. na zała­do­wa­nie się strony. A co jeżeli kilka osób na raz coś prze­sta­wia w swoich gale­riach? Wtedy na serwe­rze włącza się na kilka minut turbo hard­core i poja­wia się „Pan Gąbka” :-D
Moje rozwią­za­nie polega na wyła­pa­niu wyłącz­nie tego co wymaga zmian. Dałem kilka komen­ta­rzy dla jasności.

DELIMITER $$
CREATE PROCEDURE `reorder_image`(IN image_id INT, IN new_image_order INT)
   MODIFIES SQL DATA
   COMMENT 'Reorders images. Does nothing if given order is out of scope.'
   BEGIN
      DECLARE current_image_order, image_gallery_id, is_destination_order_exists INT;
 
      # Lapie obecne polozenie obrazka i przy okazji id galerii
      SELECT ordr, gallery_id INTO current_image_order, image_gallery_id FROM images WHERE id=image_id LIMIT 1;
 
      # Sprawdzam czy punkt docelowy w ogole istnieje
      SELECT ordr INTO is_destination_order_exists FROM images WHERE gallery_id=image_gallery_id AND ordr=new_image_order LIMIT 1;
 
      # Jezeli punkt docelowy istnieje i jest inny od obecnego TO rozpoczynam dzialanie
      IF is_destination_order_exists IS NOT NULL AND current_image_order <> new_image_order THEN
 
         # Jezeli przestawiam obrazek do gory
         IF current_image_order >  new_image_order THEN 
            WHILE current_image_order >=  new_image_order DO
               UPDATE images SET ordr=current_image_order+1 WHERE gallery_id=image_gallery_id AND ordr= current_image_order LIMIT 1;
               SET current_image_order = current_image_order - 1;
            END WHILE;
 
         # Jezeli przestawiam obrazek w dol
         ELSEIF  current_image_order <  new_image_order THEN 
            WHILE current_image_order <=  new_image_order DO
               UPDATE images SET ordr=current_image_order-1 WHERE gallery_id=image_gallery_id AND ordr= current_image_order LIMIT 1;
               SET current_image_order = current_image_order + 1;
            END WHILE;
         END IF;
 
         # Mam juz miejsce, wrzucam obrazek tam gdzie ma byc
         UPDATE images SET ordr=new_image_order WHERE id=image_id LIMIT 1;
      END IF;
END$$

Użycie prze­sta­wia­nia kolej­no­ści jest również proste:

$q = $pdo->prepare('CALL reorder_image(?,?)');
$q->bindParam(1, $imageId, PDO::PARAM_INT);
$q->bindParam(2, $wantedImageOrder, PDO::PARAM_INT);
$q->execute();

Jeśli ktoś dobrnął aż tutaj to proszę „lajk­nąć” i „plusnąć”. Niedzielne pozdro4all.

webmastering

Wygrzebane z GitHuba (4) : PHP User Agent

Dziś w progra­mie lżej­szy zamien­nik dla funk­cji get_browser()PHP User Agent. Za pomocą skryptu jeste­śmy w stanie okre­ślić jakiej prze­glą­darki i systemu opera­cyj­nego użyt­kow­nik używa. Orygi­nalna funk­cja potrze­buje pliku browscap.ini, który obec­nie zajmuje 405KB, co prze­kłada się na szyb­kość dzia­ła­nia. Poza tym istnieje niebez­pie­czeń­stwo, że na serwe­rze produk­cyj­nym nie dadzą nam dostępu do w/w funk­cji. (A przy­naj­mniej tak piszą ;-) )

Całość składa się z dwóch klas. Skrypt nie stosuje prze­strzeni nazw, za to jest całkiem nieźle udoku­men­to­wany. Ponadto jest trochę testów jednostkowych.

Używa­nie jest bardzo proste. Wystar­czy stwo­rzyć obiekt phpUserAgent i można szaleć.

$ua = new phpUserAgent();
echo $ua->getBrowserName();     // firefox
echo $ua->getBrowserVersion();   // 3.6
echo $ua->getOperatingSystem(); // linux
echo $ua->getEngine();            // gecko

Gdy nie podamy para­me­trów, obiekt korzy­sta z bieżą­cej zmien­nej $_SERVER['HTTP_USER_AGENT']. Można samemu wymu­sić inny ciąg do rozpo­zna­nia poda­jąc w konstruktorze.

Dla typo­wych konfi­gu­ra­cji użyt­kow­nika skrypt działa całkiem nieźle. Rozpo­znaje również aliasy nazw prze­glą­da­rek i syste­mów opera­cyj­nych. Z testów jednost­ko­wych widzę, że próbuje również rozpo­zna­wać boty wyszukiwarek.

Patrząc na skrypt przy­szło­ściowo już widzę rozra­sta­jącą się listę nazw i alia­sów oraz autora powoli prze­sta­ją­cego pano­wać nad tym wszyst­kim. Na razie działa, ale co będzie później? Wg mnie archi­tek­tura cało­ści jest trochę niedo­pra­co­wana. Aż prosi się o użycie wzorca projek­to­wego Łańcuch zobo­wią­zań, którego ogni­wami będą poszcze­gólne prze­glą­darki i to w ich gestii będzie rozpo­znać siebie w poda­nym im ciągu. Żeby nie uderzyć tak bardzo w wydaj­ność skryptu, łańcuch powinny rozpo­czy­nać najczę­ściej używane prze­glą­darki aż do typu Unknown.

Inne

Python okiem pehapowca

Mamy niedzielę. W ramach leniu­cho­wa­nia zachciało mi się poznać jakiś nowy język progra­mo­wa­nia. Padło na Pythona (nieznacz­nie wygrał z Rubym).

Na pierw­szy rzut oka to w zasa­dzie taki Java­Script ogól­nego prze­zna­cze­nia bez prze­glą­darki. Python rekla­mo­wany jest jako język typu batte­ries inclu­ded, czyli stan­dar­dowa biblio­teka powinna zawie­rać wszystko to, co w typo­wych zasto­so­wa­niach progra­mi­sta potrzebuje.

Od razu widać puryzm kodu Pythona. Żadnych klame­rek, żadnych śred­ni­ków — wszystko zała­twiamy wcię­ciami i końcami linii. „Kompre­sja kodu” widoczna jest na każdym kroku, np. funk­cje dekla­ru­jemy poprzez def, a nie przy­dłu­gawe func­tion, obiekty tworzymy bez new. Weźmy na przy­kład najprost­szą funk­cję żąda­jącą od użyt­kow­nika wpisa­nia z klawia­tury jakiejś liczby:

def getIntInput(message):
    while True:
        try:
            return int(input(message))
        except ValueError:
            print("You were supposed to enter integer!")

W 6 liniach mamy zała­twioną prośbę o wpisa­nie czegoś, prze­two­rze­nie wejścia i wyła­pa­nie ewen­tu­al­nych błędów. Funk­cja nie odczepi się od użyt­kow­nika dopóki nie wpisze popraw­nie jakichś cyferek.

wiek = getIntInput("Podaj rok urodzenia")

Poni­żej w punk­tach cieka­wostki, które w Pytho­nie są, a których nie ma w PHP (tyle co w ciągu kilku godzin udało mi się wyłapać):

  • wspo­mniane już braki klame­rek i śred­ni­ków — czy naprawdę potrze­bu­jemy tego wszyst­kiego w PHP?
  • wszyst­kie metody publiczne — tego nie popie­ram, może powo­do­wać bajzel w API; zgod­nie z konwen­cją metody prywatne należy ozna­czać przed­rost­kiem _
  • fajne konstruk­cje przy itero­wa­niu: for zmienna in array oraz for zmienna in range(5)
  • dziwne zasady doku­men­to­wa­nia kodu — komen­ta­rze idą po dekla­ra­cji klasy czy metody
  • array compre­hen­sion (nawet nie wiem jak to prze­tłu­ma­czyć) — w jednej linijce możemy stwo­rzyć nową tablicę na podsta­wie starej i prze­je­chać jakąś funk­cją po każdej warto­ści przed dodaniem:
    nowaTablica = [funkcja(wartosc) for wartosc in staraTablica]
  • proste loso­wa­nie:
    zagadka = random.choice(["wartosc1","wartosc2","wartosc3"])
  • tuple, czyli nieda­jąca się mody­fi­ko­wać tablica; co ciekawe, funk­cje bardzo często zwra­cają to ustroj­stwo, możemy od razu złapać je do dwóch różnych zmiennych
    wynik1, wynik2 = funkcja()
  • obiekt None zamiast null
  • == i != do spraw­dza­nia warto­ści zmien­nych, isis not do porów­ny­wa­nia z None lub refe­ren­cji, mało tego, możliwa jest konstruk­cja 0 <= a <= 10
  • próba poró­wa­nia if „3” < 4 wywali Type­Er­ror
  • konstruk­cja final do kompletu z try/except
  • bajer dla mnie: if szuka­na­Zmienna in tablica oraz if „wyraz” in przeszukiwanyString
  • nie ma czegoś tak paskud­nego jak RESOURCE

Tyle na począ­tek. Widzę, że Python to fajna sprawa. O wszyst­kim pomy­śleli. Nawet o wbudo­wa­niu bazy danych sqlite w biblio­tekę stan­dar­dową. Jeżeli ktoś waha się czego by tu nowego się pouczyć to polecam!

P.S.: Tak, wiem, na tych waszych poli­bu­dach Pythona uczą już na I roku, ble ble srutu­tutu. Samo­ucy typu np. ja muszą sami. Dobra, kończę, bo i piwo mi się skończyło :-(