Automat Addera

Adder wykorzystuje Cron do cyklicznego uruchamiania dodawania wpisów do katalogów - uruchamiania automatu.

Cron - jest to uniksowy program który ma za zadanie okresowe wywoływanie innych programów. Co jakiś czas sprawdza plik w którym zapisywane są zadania jakie ma wykonywać.
Odpowiednikiem crona w systemie Windows jest "Harmonogram zadań".

Poniższy tekst tworzony jest przy następujących założeniach:

  • pliki programu Adder skopiowane są do katalogu "adder" w głównym katalogu serwera na który wskazuje adres http://domena.pl/
  • program uruchamiany jest po wpisaniu w przeglądarce adresu http://domena.pl/adder
  • plik automatu Addera ma nazwę automat.php

Uruchomienie automatu Addera - automat.php można dokonać poprzez program który potrafi otworzyć stronę www (np. przeglądarka lynx) Zadania (polecenia) Cron na wszystkich hostingach mają jednakową strukturę. Pierwsza część określa czas uruchomienia pelecenia, druga jest właściwym poleceniem. W zależności o hostingu konfiguracja zadania może wyglądać w nieco inny sposób. O ile sposób określenia czasu uruchomienia zadania jest najbardziej zróżnicowany (usługodawcy starają się w różny sposób ułatwić konfigurację) o tyle sam opis zadania jest taki sam (wyjątek stanowi home.pl). Z tego powodu opiszemy jedynie drugą część tworzenia zadania dla Cron, pierwsza jest opisywana przez dostawce hostingu i nie powinna stanowić większego problemu.


Uruchamianie automatu przez przeglądarkę www z poziomu Crona

Uruchamianie automatu przez przeglądarkę www jest najprostszym i najmniej problematycznym sposobem, ponieważ Adder stworzony jest pod kątem uruchamiania z poziomu przeglądarki.

Polecenie Cron uruchamiające automat

lynx --dump http://domena.pl/adder/automat.php

Po wykonaniu każdego z w.w. poleceń zostanie do Państwa wysłany raport o stanie wykonania polecenia na adres głównej skrzynki pocztowej wykorzystywanej w hostingu.

Aby zapobiec wysyłaniu takiej poczty (która w zależności od częstości wykonywania poleceń może zapełnić skrzynkę), która jest przydatna przede wszytkim przy pierwszej konfiguracji Crona należy dodać na końcu polecenia tekst ">/dev/null 2>&1"

Polecenie Cron uruchamiające automat bez przysyłania wiadomości o stanie wykonania polecenia

lynx --dump http://domena.pl/adder/automat.php >/dev/null 2>&1


Konfiguracja Cron na home.pl

W przypadku home.pl konfiguracja Cron wygląda trochę inaczej.

Zadania do wykonywania umieszczane są w katalogu głównym serwera, w plikach o odpowiednich rozszerzeniach.

W katalogu adder znajduje się plik, cron-15min.php przygotowany do działania na serwerach home.pl.
Przed skopiowaniem do głównego katalogu serwera należy edytować plik i wprowadzić odpowiednie modyfikacje.
Jeśli Państwa program znajduje się w innym katalogu niż "adder/" należy w linijce z chdir('adder/') zmienić "adder/" na Państwa katalog.

W przypadku, gdy nie mają Państwo pewności w jakim katalogu znajduje się program proszę zmodyfikować 4,5 i 6 linijkę:

chdir('adder/'); // jesli plik znajduje sie w innym katalogu
// lub file_get_contents('http://domena.pl/adder/automat.php');
include_once('automat.php');

w następujący sposób:

//chdir('adder/'); // jesli plik znajduje sie w innym katalogu
file_get_contents('http://domena.pl/adder/automat.php');
//include_once('automat.php');

adres http://domena.pl/adder/automat.php zamienić na adres który muszą wpisać Państwo aby uruchomić plik automatu.


Warunki działania automatu Addera

Aby Adder dodawał wpisy automatycznie muszą zostać spełnione dwa warunki:
- Cron musi uruchamiać plik automatu Addera, w tym przypadku jest to automat.php.
- W konfiguracji strony musi zostać zaznaczona opcja "Automat".

Na "Lista moich stron", przy każdej stronie, która będzie dodawana do katalogów przez automat, w kolumnie "Automat" musi znajdować się zielony znaczek .


W jaki sposób sprawdzić czy Cron uruchamia automat

Pierwszy sposób

Należy sprawdzić czy na głównej skrzynce pocztowej hostingu na którym uruchamiany jest Adder, bądź na skrzynce podanej podczas konfiguracji Crona jest raport o statusie wykonania zadania. Możliwość taka istnieje wyłącznie w momencie, gdy w poleceniu dla Crona nie został użyty ciąg ">/dev/null 2>&1"

Drugi sposób

W zależności od okresu uruchamiania zadania, np. co 15 minut sprawdzić po tym czasie w Adderze, na "Lista moich stron", kolumna "Dziś" czy zmieniła się wartość z np. 0/15 na 5/15. Pierwsza cyfra wskazuje ilość dodań w dniu dzisiejszym, zwiększanie się tej wartości oznacza działanie crona i automatu. Należy zwrócić uwagę na to aby w czasie oczekiwania na wykonanie zadania przez Cron nie uruchamiać opcji "uruchom" w kolumnie "Dodawanie", co powoduje zwiększanie się ilości dodań "na dzień"