Potonula Radionica
PHP / MySQL · vodič za cPanel

Kandidat za staging. Lokalna provjera nije potvrda da Totohost podržava potrebne limite. Prvo dovrši provjere u RELEASE-CHECKS.md. Postojeća stranica i izdanje bez prijave ostaju dostupni do završetka pilota.

ZIP uključuje izgrađeno sučelje i PHP ovisnosti. Na hostingu ne treba instalirati Node, Composer ili terminal. Ilustracije prikazuju raspored i korake; nisu snimke stvarnog Totohost računa.

1. Zaseban staging i baza

  1. U cPanelu otvori Domains → Create a New Domain. Izradi staging.museum.igorfarkas.com ako je dostupan. Isključi dijeljenje document roota s glavnom stranicom. Aktiviraj SSL / AutoSSL i prisili HTTPS.
  2. U MySQL Databases / Database Wizard izradi novu bazu i novog korisnika, npr. CPANEL_radionica_stage. Tom korisniku dodijeli prava samo na tu bazu. Nemoj mijenjati postojeće baze drugih stranica.
  3. U MultiPHP Manager / Select PHP Version odaberi PHP 8.4 za staging domenu. Uključi pdo_mysql, mbstring, curl, openssl, fileinfo, dom, xml, zip, zlib i standardna Laravel proširenja.
  4. U MultiPHP INI Editor provjeri: memorija najmanje 512 MiB, post_max_size=40M, max_execution_time=120. MySQL mora biti 8.x, InnoDB, max_allowed_packet ≥ 64 MiB. Ako korisnik ne može promijeniti MySQL limit, zatraži promjenu od Totohosta.
  5. Provjeri prostor i inodes za aplikaciju, prethodno izdanje i sedam dnevnih kopija baze. Potvrdi ograničenje istodobnih PHP procesa, CPU/RAM/IO, HTTP tijela zahtjeva i cron izvršavanja. Izmjerenu lokalnu potrošnju pronađi u release provjerama.

2. Raspored datoteka

U File Manageru uključi Show Hidden Files. Učitaj i raspakiraj ZIP u novi direktorij izvan public_html, npr. /home/CPANEL/radionica-stage. Document root staging domene postavi točno na njegov poddirektorij public.

/home/CPANEL/radionica-stage/public/ ← Document root domeneindex.php · .htaccess · build/models/ · artifacts/ · history/Dostupno preglednikuprivate/ ← izvan web-korijena.env · vendor/ · app/ · resources/database/ · storage/ · artisanLozinke, privatne slike, logovi, kopije

Ne premještaj samo index.php i ne postavljaj cijeli raspakirani direktorij kao web-korijen. Ako cPanel ograničava document root na public_html, Totohost mora omogućiti gornji raspored prije instalacije. private/.htaccess dodatna je zaštita; privatne datoteke i dalje moraju biti izvan web-korijena.

PHP korisnik mora moći pisati u private/storage i private/bootstrap/cache. Uobičajeno direktoriji 0755, datoteke 0644, a .env 0600; prilagodi vlasništvu hosting računa. Nemoj postaviti 0777.

3. Privatna konfiguracija i e-pošta

U cPanel Email Accounts izradi namjenski SMTP sandučić. Preuzmi točan host, port i sigurnosni način iz Connect Devices. Potvrdi satnu SMTP kvotu s Totohostom. Provjeri ispravnost SPF/DKIM za taj sandučić bez prepisivanja zapisa drugih servisa.

Kopiraj private/.env.example u private/.env i popuni APP_URL adresom staginga, nazive baze s cPanel prefiksom, korisnika, lozinku, SMTP podatke te MAIL_HOURLY_LIMIT prema potvrđenoj kvoti (zadano 30 pokušaja/sat). Zadrži APP_ENV=production, APP_DEBUG=false i SESSION_SECURE_COOKIE=true. Za port 465 koristi MAIL_SCHEME=smtps; za STARTTLS 587 MAIL_SCHEME=smtp.

Ovaj gumb lokalno generira dvije zasebne tajne pomoću kriptografskog generatora preglednika. Ne šalje podatke mrežom. Otvori ovaj vodič s računala; ne objavljuj ga s generiranim vrijednostima.

Vrijednosti još nisu generirane.

APP_KEY sačuvaj odvojeno od hosting računa. Njime se štite sesije, red e-pošte i privatni ZIP sigurnosne kopije. Bez tog ključa ne možeš dešifrirati privatnu kopiju. Nemoj ga mijenjati pri nadogradnji. SETUP_SECRET ukloni nakon uspješne instalacije.

4. Postavljanje u pregledniku

  1. Otvori https://staging.museum.igorfarkas.com/setup. Unesi SETUP_SECRET iz privatne konfiguracije i klikni Provjeri poslužitelj. Prikaz mora potvrditi PHP verziju web-stranice, sva proširenja, MySQL i limite; ready mora biti true.
  2. Unesi početnog administratora i jaku lozinku. Dovrši postavljanje stvara tablice i uvozi nastavnu vježbu s provjerom kontrolnih suma modela i slika. Ne kopira testne račune ili studentske radove.
  3. Provjeri prijavu na /login. Instalacija stvara private/storage/installed.lock; /setup i API nakon toga moraju vratiti 404. Zadrži tu datoteku trajno, također tijekom nadogradnji.

5. Jedan cron posao

U Advanced → Cron Jobs odaberi svaku minutu (* * * * *). Potvrdi točan PHP 8.4 CLI put s Totohostom; primjer ispod vrijedi samo ako taj put postoji:

/usr/local/bin/ea-php84 -d memory_limit=512M /home/CPANEL/radionica-stage/private/artisan radionica:tick >> /home/CPANEL/radionica-stage/private/storage/logs/cron.log 2>&1

CLI cron ne čita javnu .user.ini datoteku. Zato je memorijski limit naveden i u naredbi. Potvrdi da hosting dopušta taj limit i dovoljno vremena za najviše pet SMTP pokušaja i do 75 sekundi izrade kopije.

Obrada ima zaključavanje protiv preklapanja, šalje najviše pet poruka po prolazu unutar satne kvote, uklanja istekle sesije i radi dnevnu kopiju. U administraciji provjeri vrijeme posljednje obrade, sigurnosnu kopiju i pogreške slanja. SMTP prihvat poruke ne dokazuje dostavu u sandučić: potvrdi primitak poziva i obnove lozinke na dvije vanjske adrese.

6. Sigurnosne kopije i oporavak

private/storage/backups sadrži gzip SQL, šifrirani privatni ZIP i .complete.json s SHA-256 kontrolnim sumama. Čuva se najmanje sedam različitih uspješnih dnevnih točaka; nepotpuna kopija ne računa se kao uspjeh. Prvih sedam dana broj raste od jedne do sedam. Privatne nastavne slike i predaje nalaze se u bazi. Kod i javni modeli obnavljaju se iz sačuvanog izdanja aplikacije.

SQL sadrži studentske podatke. Preuzimaj ga samo kroz zaštićeni cPanel i čuvaj u sigurnoj izvanmrežnoj pohrani. Potvrdi Totohostove neovisne sigurnosne kopije, razdoblje čuvanja i postupak vraćanja. Kopija u istom hosting računu ne štiti od gubitka cijelog računa.

  1. Za probu oporavka izradi novu, praznu staging bazu. Ne uvozi preko baze s radovima.
  2. Provjeri SHA-256 iz .complete.json. U phpMyAdmin Import uvezi .sql.gz. Za kopiju veću od uvoznog limita zatraži hosting import; aplikacija namjerno nema javni restore endpoint.
  3. Privatni ZIP dešifriraj lokalno spremljenim APP_KEY (npr. 7-Zip s AES podrškom). Vrati konfiguraciju i installed.lock izvan web-korijena, uz DB podatke nove baze.
  4. Prijavi se, usporedi broj računa, restauracija i predaja te otvori nekoliko zamrznutih izvještaja i slika. Aktivne sesije i red e-pošte namjerno se ne vraćaju; administrator ponovno šalje potrebne pozive.

7. Staging, pilot i prijelaz

Provjeri izravno otvaranje /workshop, /museum, /timeline i mentorovih poveznica, desktop i mobitel, tipkovnicu, dodir i puni zaslon za svih pet predmeta. Provjeri spremanje izvan mreže i izričit izbor kod sukoba. Profil omogućuje uvoz lokalnih zapisa iz izdanja bez prijave na istom originu; izvornici se ne brišu. Staging na drugoj poddomeni ne vidi browser bazu produkcijske domene.

Pokušaji preuzimanja /.env, /private/.env, /storage/logs/laravel.log, /resources/cases/bundle.json i /.user.ini moraju biti odbijeni. Neprijavljen korisnik ne smije preuzeti nastavne slike. Provjeri HTTPS, sigurnosne oznake kolačića i CSRF. Ponovi lokalni scenarij 30 istodobnih studenata na stagingu prije tvrdnje da hosting podržava razred.

Nakon svih provjera izradi zasebnu praznu produkcijsku bazu, konfiguraciju i novi APP_KEY/SETUP_SECRET te ponovi instalaciju za museum.igorfarkas.com. Sačuvaj prethodni document root i ZIP. Prvo pozovi jednog mentora i dva testna studenta. Tek nakon dovršenog zadatka, predaje, povratne informacije i dorade otvori pozive za cijeli razred.

8. Nadogradnja i povratak izdanja

  1. Najprije isprobaj nadogradnju na staging kopiji baze. Sačuvaj prethodni ZIP, konfiguraciju i provjerenu sigurnosnu kopiju.
  2. Raspakiraj novo izdanje u novi direktorij. Prenesi postojeći private/.env i cijeli private/storage, uključujući installed.lock i stare kopije. Ne prepisuj ih praznim direktorijima iz ZIP-a. Ne mijenjaj APP_KEY. Usporedi .env.example za nove opcije.
  3. U dogovorenom terminu zaustavi spremanje/odjavi pilot i privremeno pauziraj redoviti cron. Jednokratnim cPanel cron poslom pokreni .../ea-php84 .../novo-izdanje/private/artisan radionica:upgrade >> .../private/storage/logs/upgrade.log 2>&1. On prvo radi kopiju, zatim samo migracije na više i provjeru nastavnog slučaja. Ukloni jednokratni cron nakon poruke Upgrade complete. Za ponovni pokušaj uvijek pregledaj log.
  4. Preusmjeri document root na novi public i redoviti cron na novi private. Ponovi prijavu, spremanje i čitanje starih predaja.
  5. Ako je potrebno, vrati prethodni document root i cron tek nakon provjere da prethodni kod podržava postojeću shemu. Zadrži aktualnu bazu i studentske radove. Ne pokreći migrate:fresh, reset ili migracije prema dolje. Ako shema nije kompatibilna, koristi popravak unaprijed ili zasebnu obnovljenu bazu uz usporedbu novijih radova.

Ovo je prvo PHP izdanje. Prethodno Node/PostgreSQL ili statičko izdanje ne može čitati novu MySQL bazu; povratak na njega zadržava bazu, ali privremeno ne prikazuje radove nastale u PHP izdanju. Nemoj ih brisati.

Dokumentacija

Laravel deployment · Laravel CSRF · cPanel cron. Puni opis implementacije i razvojnih provjera nalazi se u repozitoriju totohost/README.md.