Python je eden najbolj priljubljenih programskih jezikov, z njim pa lahko izdelate tudi spletno aplikacijo. V tem prispevku boste korak za korakom postavili svojo prvo Python aplikacijo na našem gostovanju. Potrebujete samo dostop do nadzorne plošče cPanel; znanje strežnikov ni potrebno.

Ko boste končali, boste imeli na svoji domeni delujočo aplikacijo v ogrodju Flask, ki je najbolj preprosto Python spletno ogrodje.

Kazalo

• Kaj potrebujete?
• 1. korak: ustvarite aplikacijo
• 2. korak: namestite Flask
• 3. korak: pripravite aplikacijo
• 4. korak: ponovno zaženite aplikacijo
• Ko vaša aplikacija potrebuje več paketov
• Kje najdem napake?
• Kako aplikacija teče?
• Kaj še lahko uporabljate?
• Naslednji koraki

Kaj potrebujete?

Za postavitev Python aplikacije na spletnem gostovanju potrebujete:

• Paket gostovanja, ki podpira Python: Zeleni, Modri, Rdeči ali kateri koli paket Reseller oz. Turbo gostovanja.
• Domeno, ki je dodana na paket gostovanja.

Ali vaš paket podpira Python, preverite v cPanel. Kot prikazuje zgornja slika, mora v sekciji Software obstajati ikona Setup Python App. Če je ni, lahko paket gostovanja vedno nadgradite.

1. korak: ustvarite aplikacijo

1. V cPanel odprite Setup Python App in kliknite CREATE APPLICATION.

2. Izpolnite polja:

• Python version: izberite 3.12. Na voljo so različice od 2.7 do 3.13 (na novejših strežnikih tudi 3.14), za nove projekte priporočamo 3.12.
• Application root: ime mape, v kateri bo koda, npr. flaskapp. Mapa je v vaši domači mapi, izven public_html, zato koda ni javno dostopna.
• Application URL: naslov aplikacije, npr. vasadomena.si/flaskapp. Če pustite prazno, bo aplikacija na glavnem naslovu domene.
• Application startup file: pustite prazno, cPanel bo uporabil passenger_wsgi.py.
• Application Entry point: pustite prazno, cPanel bo uporabil application.

3. Kliknite CREATE.

Odprite https://vasadomena.si/flaskapp. Izpiše se »It works!« in vaša Python aplikacija že deluje. Izpis prihaja iz datoteke passenger_wsgi.py, ki jo je ustvaril cPanel.

2. korak: namestite Flask

Python aplikacija ima svoje virtualno okolje (ang. virtual environment), v katerega nameščate pakete. Tako paketi ene aplikacije ne vplivajo na druge.

Na vrhu strani aplikacije v Setup Python App je ukaz za vstop v virtualno okolje, na primer:

source /home/uporabnik/virtualenv/flaskapp/3.12/bin/activate && cd /home/uporabnik/flaskapp

Kopirajte ga, v cPanel odprite Terminal (sekcija ADVANCED) ali se povežite prek SSH, prilepite zgornji ukaz in nato namestite Flask:

pip install flask

3. korak: pripravite aplikacijo

V cPanel odprite File Manager, pojdite v mapo flaskapp in ustvarite datoteko app.py:

from flask import Flask

app = Flask(__name__)

@app.route("/")
def domov():
    return "Pozdravljen, svet! To je moja prva Python aplikacija."

@app.route("/pozdrav/<ime>")
def pozdrav(ime):
    return f"Pozdravljen, {ime}!"

Nato uredite datoteko passenger_wsgi.py. Izbrišite vso vsebino in vpišite:

import os
import sys

sys.path.insert(0, os.path.dirname(__file__))

from app import app as application

Strežnik iz datoteke passenger_wsgi.py vedno prebere spremenljivko application. Zgornja koda vanjo shrani vašo Flask aplikacijo.

4. korak: ponovno zaženite aplikacijo

V Setup Python App pri aplikaciji kliknite RESTART. To morate storiti po vsaki spremembi kode.

Odprite https://vasadomena.si/flaskapp in https://vasadomena.si/flaskapp/pozdrav/Janez. Če vidite pozdrav, je vse nastavljeno pravilno.

Ko vaša aplikacija potrebuje več paketov

Večji projekti imajo datoteko requirements.txt s seznamom vseh paketov.

Na svojem računalniku jo ustvarite z ukazom pip freeze > requirements.txt, naložite v mapo aplikacije in na strežniku v virtualnem okolju zaženite:

pip install -r requirements.txt

Pakete lahko namestite tudi brez ukazne vrstice: v Setup Python App pod Configuration files dodajte requirements.txt in kliknite Run Pip Install.

Kje najdem napake?

Če aplikacija vrne napako »Internal Server Error« ali se ne odpre, poglejte datoteko stderr.log v mapi aplikacije (npr. flaskapp/stderr.log). Vanjo se zapišejo vse napake Pythona.

Najpogostejše napake so:

• ModuleNotFoundError: No module named 'flask': paket ni nameščen v virtualnem okolju aplikacije. Preverite, ali ste pred pip install zagnali ukaz source .../bin/activate.
• ImportError ali napaka v passenger_wsgi.py: ime datoteke ali spremenljivke se ne ujema (npr. datoteka se imenuje main.py, v passenger_wsgi.py pa piše from app import ...).
• Sprememba kode se ne pozna: aplikacijo ponovno zaženite (RESTART).

Kako aplikacija teče?

Aplikacija ne teče ves čas. Spletni strežnik jo zažene ob prvem obisku, po nekaj minutah brez obiskov pa jo zaustavi, da ne porablja sredstev. Prvi obisk po premoru zato traja približno sekundo dlje, vsi nadaljnji so hitrejši.

Kaj še lahko uporabljate?

Poleg ogrodja Flask lahko pri razvoju Python aplikacije uporabljate tudi druge funkcionalnosti:

• Podatkovna baza: MySQL (MariaDB) ustvarite v cPanel pod MySQL Databases, od paketa Zeleni naprej je na voljo tudi PostgreSQL. Navodila: Python aplikacija in baza MySQL.
• SSH, Git in pip: vse je na voljo na paketih, ki podpirajo Python.
• Spremenljivke okolja: gesla in ključe vpišite v Setup Python App pod Environment variables, ne v kodo.

Naslednji koraki

Ko uspešno postavite svojo prvo Python aplikacijo, lahko znanje nadgradite z naslednjimi vsebinami:

• Python aplikacija na spletnem gostovanju: podroben vodnik za Flask, Django in FastAPI, omejitve paketov in rešitve najpogostejših napak (tudi za aplikacije, izdelane z AI asistentom).
• Django aplikacija v cPanel okolju
• Vue ali React frontend s Python (FastAPI) zaledjem

Če se kje zatakne, nam pišite, z veseljem vam pomagamo.