آموزش فریمورک فلسک | مسیرها و URLها

تعریف مسیرها

در فریمورک فلسک، مسیرها (Routes) قلب برنامه شما هستند. مسیرها مشخص می‌کنند که وقتی کاربر یک URL خاص را در مرورگر خود تایپ می‌کند، برنامه شما چه پاسخی باید بدهد. برای مثال، اگر کاربر به آدرس http://localhost:5000/ مراجعه کند، فلسک باید صفحه اصلی را به او نشان دهد.

برای تعریف یک مسیر، از دکوراتور @app.route() استفاده می‌کنیم. این دکوراتور بالای یک تابع (Function) قرار می‌گیرد و به فلسک می‌گوید: "هرگاه کاربر به این آدرس رفت، این تابع را اجرا کن."

ساختار ساده:

from flask import Flask

app = Flask(__name__)

@app.route('/')
def home():
    return "سلام! به سایت من خوش آمدید."

توضیح خط به خط:

• from flask import Flask: کتابخانه اصلی فلسک را وارد می‌کنیم.
• app = Flask(__name__): یک نمونه از برنامه فلسک می‌سازیم. __name__ نام ماژول فعلی را به فلسک می‌دهد تا بتواند مسیر فایل‌ها را پیدا کند.
• @app.route('/'): این دکوراتور به فلسک می‌گوید که این تابع مربوط به مسیر ریشه (/) است. مسیر ریشه یعنی همان آدرس اصلی سایت بدون هیچ پسوندی (مثلاً http://localhost:5000/).
• def home(): : نام تابع می‌تواند هر چیزی باشد، اما معمولاً نام‌های معنادار انتخاب می‌کنیم.
• return "سلام! به سایت من خوش آمدید.": هر چیزی که تابع return کند، همان محتوایی است که در مرورگر کاربر نمایش داده می‌شود.

مسیرهای مختلف:

شما می‌توانید مسیرهای مختلفی با نام‌های دلخواه تعریف کنید. مثلاً:

@app.route('/about')
def about():
    return "این صفحه درباره ما است."

@app.route('/contact')
def contact():
    return "برای تماس با ما، ایمیل بزنید."

حالا اگر کاربر به آدرس http://localhost:5000/about برود، متن "این صفحه درباره ما است." را می‌بیند.

توجه مهم:

• مسیرها همیشه با / شروع می‌شوند.
• حروف کوچک و بزرگ در مسیرها مهم هستند. یعنی /About با /about تفاوت دارد.
• اگر تابعی را برای یک مسیر تعریف نکنید و کاربر به آن مسیر مراجعه کند، فلسک خطای 404 (پیدا نشد) را نشان می‌دهد.

مثال عملی در ویرایشگر آنلاین:

فرض کنید در ویرایشگر آنلاین کد زیر را تایپ کنید:

from flask import Flask
app = Flask(__name__)

@app.route('/')
def hello():
    return "اولین مسیر من!"

@app.route('/test')
def test():
    return "این مسیر آزمایشی است!"

if __name__ == "__main__":
    app.run()

حالا اگر برنامه را اجرا کنید و در مرورگر آدرس http://localhost:5000/ را بزنید، پیام "اولین مسیر من!" را می‌بینید. اگر آدرس http://localhost:5000/test را بزنید، پیام "این مسیر آزمایشی است!" ظاهر می‌شود.

به این ترتیب، شما یاد گرفتید که چگونه با استفاده از دکوراتور @app.route()، مسیرهای ساده را در فلسک تعریف کنید. این پایه تمام صفحات وب شما خواهد بود.