KAHIBARO Bookshelves
Discord Login Register

15.3. ساخت یک وب‌سرور ساده

شروع عملی: ساخت وب‌سرور با Flask

در بخش «آشنایی با Flask» با این فریم‌ورک به‌طور کلی آشنا شده‌اید. اینجا قدم‌به‌قدم یک وب‌سرور بسیار ساده می‌سازیم که روی کامپیوتر شما اجرا می‌شود و در مرورگر قابل مشاهده است.

هدف این بخش:

  • ساخت یک وب‌سرور مینیمال با Flask
  • تعریف چند مسیر ساده (Route)
  • نمایش متن ساده در مرورگر
  • درک چرخهٔ اجرای درخواست تا پاسخ (بدون ورود به جزئیات Templateها و فرم‌ها که در فصل بعد می‌آیند)

پیش‌نیازها

برای ادامهٔ این بخش فرض می‌کنیم:

  • پایتون روی سیستم شما نصب است.
  • Flask را نصب کرده‌اید (در فصل «آشنایی با Flask» یا «استفاده از کتابخانه‌ها» طریقه نصب را دیده‌اید). اگر نصب نیست:
pip install flask

یا روی بعضی سیستم‌ها:

pip3 install flask

ساخت اولین فایل وب‌سرور

۱. یک پوشهٔ جدید بسازید، مثلاً با نام my_first_webapp.
۲. داخل این پوشه، یک فایل جدید بسازید: app.py.

کد زیر را در app.py قرار دهید:

from flask import Flask
app = Flask(__name__)
@app.route("/")
def home():
    return "سلام! این اولین وب‌سرور سادهٔ من با Flask است."
if __name__ == "__main__":
    app.run()

در این کد چه اتفاقی می‌افتد (به‌صورت خیلی خلاصه و فقط مخصوص این مثال):

  • Flask را وارد می‌کنیم تا بتوانیم از آن استفاده کنیم.
  • با app = Flask(__name__) یک «برنامهٔ وب» می‌سازیم.
  • با @app.route("/") می‌گوییم اگر کاربر به آدرس اصلی سایت (ریشه) یعنی / رفت، تابع home اجرا شود.
  • تابع home یک متن معمولی (رشتهٔ پایتون) برمی‌گرداند.
  • بخش if __name__ == "__main__": باعث می‌شود وقتی فایل را مستقیم اجرا می‌کنیم، وب‌سرور روشن شود.

اجرای وب‌سرور

در همان پوشه‌ای که app.py است، ترمینال (یا Command Prompt) را باز کنید و بنویسید:

python app.py

(اگر سیستم شما از python3 استفاده می‌کند:)

python3 app.py

اگر همه چیز درست باشد، در ترمینال چیزی شبیه به این می‌بینید:

 * Serving Flask app 'app'
 * Debug mode: off
 * Running on http://127.0.0.1:5000

حالا:

  • مرورگر خود را باز کنید.
  • در نوار آدرس، این را وارد کنید: http://127.0.0.1:5000/
  • باید متن زیر را ببینید:

سلام! این اولین وب‌سرور سادهٔ من با Flask است.

این یعنی وب‌سرور شما در حال اجرا است و درخواست‌های مرورگر را پاسخ می‌دهد.

مفهوم «مسیر» (Route) در وب‌سرور ساده

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

  • / برای صفحهٔ اصلی
  • /about برای صفحهٔ «درباره ما»
  • /hello برای صفحهٔ سلام

در Flask، هر آدرس را با یک دکوریتور @app.route تعریف می‌کنیم.

کد زیر را به همان فایل app.py اضافه کنید (زیر تابع home):

@app.route("/about")
def about():
    return "این یک صفحهٔ سادهٔ about است."
@app.route("/hello")
def hello():
    return "سلام از مسیر /hello!"

حالا دوباره (اگر سرور در حال اجراست، لازم نیست دوباره اجرا کنید؛ ولی اگر بسته‌اید، دوباره python app.py را اجرا کنید) به این آدرس‌ها بروید:

  • http://127.0.0.1:5000/about
  • http://127.0.0.1:5000/hello

و متن‌های تعریف‌شده را ببینید.

نکته‌های مهم این وب‌سرور ساده:

  • هر تابعی که با @app.route("...") تزئین شده باشد، وقتی کاربر به آن آدرس برود، اجرا می‌شود.
  • خروجی تابع باید چیزی باشد که Flask بتواند به مرورگر برگرداند؛ در ساده‌ترین حالت یک رشته (str) است.

فعال کردن حالت دیباگ (برای توسعه)

برای اینکه هنگام تغییر کد لازم نباشد هر بار سرور را دستی خاموش و روشن کنید، می‌توانید حالت توسعه (Debug) را روشن کنید.

کد app.run() را به این شکل تغییر دهید:

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

حالا وقتی فایل را ذخیره کنید، Flask خودش سرور را ری‌استارت می‌کند و تغییرات را اعمال می‌کند.

هشدار کوتاه:
حالت debug=True فقط برای محیط توسعه (روی کامپیوتر خودتان) مناسب است، نه برای سرور واقعی در اینترنت.

استفاده از متغیر در آدرس‌ها (Route با پارامتر)

گاهی می‌خواهید آدرس شما بخش متغیر داشته باشد، مثل:

  • /user/ali
  • /user/sara

می‌توانیم در تعریف مسیر، یک قسمت متغیر بگذاریم. مثال:

@app.route("/user/<name>")
def user_page(name):
    return f"سلام {name} عزیز!"

حالا:

  • با http://127.0.0.1:5000/user/ali متن سلام ali عزیز!
  • و با http://127.0.0.1:5000/user/sara متن سلام sara عزیز!

را خواهید دید.

چند نکته:

  • <name> در آدرس، نام یک پارامتر است.
  • همین نام باید در آرگومان تابع (name) استفاده شود.
  • داخل تابع می‌توانید از این مقدار مثل هر متغیر معمولی استفاده کنید.

نمایش چند خط متن یا HTML ساده

تا اینجا فقط متن ساده برگرداندیم. وب‌صفحه‌ها معمولا با HTML ساخته می‌شوند. در این بخش هنوز وارد بحث Templateها نمی‌شویم، فقط نشان می‌دهیم که می‌توانید HTML را هم به عنوان رشته برگردانید.

مثال:

@app.route("/html")
def simple_html():
    return """
    <h1>سلام!</h1>
    <p>این یک صفحهٔ HTML خیلی ساده است.</p>
    <p>هنوز از قالب‌ها (Templates) استفاده نکرده‌ایم.</p>
    """

حالا با رفتن به http://127.0.0.1:5000/html می‌بینید که مرورگر HTML را تفسیر می‌کند (تیتر بزرگ، پاراگراف و ...).

در فصل بعدی («مسیرها و قالب‌ها (Templates)») یاد می‌گیرید که به‌جای نوشتن HTML در رشته‌ها، از فایل‌های جداگانه و تمیز برای قالب‌ها استفاده کنید.

بستن وب‌سرور

برای خاموش کردن وب‌سرور:

  • به ترمینال برگردید که سرور در آن در حال اجراست.
  • کلیدهای Ctrl + C را بزنید.

این کار اجرای سرور Flask را متوقف می‌کند.

تمرین‌های پیشنهادی

چند تمرین کوچک برای تثبیت مفاهیم این بخش:

  1. وب‌سایت سه‌صفحه‌ای کوچک
    • یک برنامهٔ Flask بسازید که سه مسیر داشته باشد:
      • / (صفحهٔ اصلی)
      • /about
      • /contact
    • هر کدام یک متن متفاوت برگردانند.
  2. آدرس با نام پویا
    • مسیری مثل /hi/<username> تعریف کنید که بنویسد:
      • سلام username، خوش آمدی!
  3. استفاده از چند خط HTML
    • مسیری بسازید که یک فهرست (<ul>) از سه آیتم مورد علاقهٔ شما (مثلاً غذا، فیلم یا شهر) را در HTML نمایش دهد.
  4. ترکیب متن ثابت و متغیر
    • مسیری بسازید مانند /square/<number> که عدد را بگیرد و مربع آن را حساب کند و نمایش دهد، مثلاً:
      • آدرس: /square/5
      • خروجی: عدد 5، مربعش 25 است.

در فصل بعدی، یاد می‌گیرید چطور این وب‌سرور ساده را با استفاده از مسیرهای بیشتر و قالب‌ها (Templates) به یک وب‌سایت مرتب‌تر و قابل‌گسترش تبدیل کنید.

Views: 0

Comments

Please login to add a comment.

Don't have an account? Register now!

Where to Move

Move chapter:

  • ☰ 1. فصل ۱: برنامه‌نویسی چیست؟
    • ☰ 1.1. برنامهٔ کامپیوتری چیست؟
      • ☰ 1.2. پایتون چیست؟
        • ☰ 1.3. پایتون کجا استفاده می‌شود؟
          • ☰ 1.4. چگونه برنامه‌نویسی به حل مسائل کمک می‌کند
            • ☰ 1.5. اولین برنامهٔ پایتون شما
            • ☰ 2. فصل ۲: راه‌اندازی پایتون
              • ☰ 2.1. نصب پایتون (ویندوز / macOS / لینوکس)
                • ☰ 2.2. استفاده از پایتون در ترمینال
                  • ☰ 2.3. استفاده از یک IDE (IDLE / VS Code)
                    • ☰ 2.4. اجرای اسکریپت‌های پایتون
                      • ☰ 2.5. حالت تعاملی پایتون
                      • ☰ 3. فصل ۳: متغیرها و انواع داده
                        • ☰ 3.1. متغیر چیست؟
                          • ☰ 3.2. ایجاد متغیرها
                            • ☰ 3.3. اعداد (`int`، `float`)
                              • ☰ 3.4. متن (`str`)
                                • ☰ 3.5. مقادیر بولی (`True`، `False`)
                                  • ☰ 3.6. بررسی نوع داده با `type()`
                                  • ☰ 4. فصل ۴: عملیات پایه
                                    • ☰ 4.1. عملیات حسابی
                                      • ☰ 4.2. کار با اعداد
                                        • ☰ 4.3. عملیات روی رشته‌ها
                                          • ☰ 4.4. ترکیب متن و متغیرها
                                            • ☰ 4.5. کامنت‌ها در پایتون
                                            • ☰ 5. فصل ۵: ورودی و خروجی کاربر
                                              • ☰ 5.1. دریافت ورودی از کاربر
                                                • ☰ 5.2. تبدیل ورودی به عدد
                                                  • ☰ 5.3. قالب‌بندی خروجی
                                                    • ☰ 5.4. نوشتن برنامه‌های تعاملی
                                                    • ☰ 6. فصل ۶: شرط‌ها (if / else)
                                                      • ☰ 6.1. عملگرهای مقایسه‌ای
                                                        • ☰ 6.2. عملگرهای منطقی
                                                          • ☰ 6.3. if، elif، else
                                                            • ☰ 6.4. شرط‌های تو در تو
                                                              • ☰ 6.5. اشتباهات رایج مبتدیان
                                                              • ☰ 7. فصل ۷: حلقه‌ها
                                                                • ☰ 7.1. چرا حلقه‌ها مفید هستند؟
                                                                  • ☰ 7.2. حلقه‌های while
                                                                    • ☰ 7.3. حلقه‌های for
                                                                      • ☰ 7.4. شمارنده‌های حلقه
                                                                        • ☰ 7.5. break و continue
                                                                          • ☰ 7.6. تمرین‌های حلقه
                                                                          • ☰ 8. فصل ۸: مجموعه‌های داده
                                                                            • ☰ 8.1. لیست‌ها (Lists)
                                                                              • ☰ 8.2. تاپل‌ها (Tuples)
                                                                                • ☰ 8.3. دیکشنری‌ها (Dictionaries)
                                                                                  • ☰ 8.4. مجموعه‌ها (Sets – مقدماتی)
                                                                                    • ☰ 8.5. انتخاب ساختار دادهٔ مناسب
                                                                                    • ☰ 9. فصل ۹: توابع
                                                                                      • ☰ 9.1. چرا توابع مهم هستند؟
                                                                                        • ☰ 9.2. تعریف توابع
                                                                                          • ☰ 9.3. پارامترها و آرگومان‌ها
                                                                                            • ☰ 9.4. مقادیر بازگشتی
                                                                                              • ☰ 9.5. محدودهٔ متغیرها (محلی در برابر سراسری)
                                                                                                • ☰ 9.6. استفادهٔ مجدد از کد
                                                                                                • ☰ 10. فصل ۱۰: کار با فایل‌ها
                                                                                                  • ☰ 10.1. فایل چیست؟
                                                                                                    • ☰ 10.2. خواندن فایل‌های متنی
                                                                                                      • ☰ 10.3. نوشتن و افزودن به فایل‌ها
                                                                                                        • ☰ 10.4. مسیر فایل‌ها
                                                                                                          • ☰ 10.5. برنامه‌های ساده مبتنی بر فایل
                                                                                                          • ☰ 11. فصل ۱۱: خطاها و اشکال‌زدایی
                                                                                                            • ☰ 11.1. انواع خطاها
                                                                                                              • ☰ 11.2. خواندن پیام‌های خطا
                                                                                                                • ☰ 11.3. خطاهای رایج مبتدیان
                                                                                                                  • ☰ 11.4. try و except
                                                                                                                    • ☰ 11.5. راهبردهای اشکال‌زدایی
                                                                                                                    • ☰ 12. فصل ۱۲: استفاده از کتابخانه‌های پایتون
                                                                                                                      • ☰ 12.1. کتابخانه چیست؟
                                                                                                                        • ☰ 12.2. وارد کردن ماژول‌ها
                                                                                                                          • ☰ 12.3. کتابخانه‌های استاندارد
                                                                                                                            • ☰ 12.3.1. math
                                                                                                                              • ☰ 12.3.2. random
                                                                                                                                • ☰ 12.3.3. datetime
                                                                                                                                • ☰ 12.4. نصب کتابخانه‌های خارجی با pip
                                                                                                                                • ☰ 13. فصل ۱۳: برنامه‌نویسی شی‌گرا (OOP)
                                                                                                                                  • ☰ 13.1. برنامه‌نویسی شی‌گرا چیست؟
                                                                                                                                    • ☰ 13.2. کلاس‌ها و اشیاء
                                                                                                                                      • ☰ 13.3. ویژگی‌ها و متدها
                                                                                                                                        • ☰ 13.4. متد `__init__`
                                                                                                                                          • ☰ 13.5. کپسوله‌سازی
                                                                                                                                            • ☰ 13.6. وراثت (مقدماتی)
                                                                                                                                              • ☰ 13.7. مثال‌های سادهٔ شی‌گرا
                                                                                                                                              • ☰ 14. فصل ۱۴: خودکارسازی با پایتون
                                                                                                                                                • ☰ 14.1. خودکارسازی چیست؟
                                                                                                                                                  • ☰ 14.2. خودکار کردن وظایف ساده
                                                                                                                                                    • ☰ 14.3. کار با فایل‌ها و پوشه‌ها
                                                                                                                                                      • ☰ 14.4. خودکارسازی پردازش متن
                                                                                                                                                        • ☰ 14.5. زمان‌بندی اجرای اسکریپت‌ها
                                                                                                                                                          • ☰ 14.6. مثال‌های کاربردی خودکارسازی
                                                                                                                                                          • ☰ 15. فصل ۱۵: توسعهٔ وب با پایتون
                                                                                                                                                            • ☰ 15.1. وب چگونه کار می‌کند؟ (نمای کلی)
                                                                                                                                                              • ☰ 15.2. آشنایی با Flask
                                                                                                                                                                • ☰ 15.3. ساخت یک وب‌سرور ساده
                                                                                                                                                                  • ☰ 15.4. مسیرها و قالب‌ها (Templates)
                                                                                                                                                                    • ☰ 15.5. پردازش ورودی کاربر (فرم‌ها)
                                                                                                                                                                      • ☰ 15.6. API های بسیار ساده
                                                                                                                                                                      • ☰ 16. فصل ۱۶: علم داده با پایتون
                                                                                                                                                                        • ☰ 16.1. علم داده چیست؟
                                                                                                                                                                          • ☰ 16.2. کار با داده‌ها
                                                                                                                                                                            • ☰ 16.3. آشنایی با NumPy
                                                                                                                                                                              • ☰ 16.4. آشنایی با pandas
                                                                                                                                                                                • ☰ 16.5. مصورسازی داده با matplotlib
                                                                                                                                                                                  • ☰ 16.6. مثال‌های سادهٔ تحلیل داده
                                                                                                                                                                                  • ☰ 17. فصل ۱۷: پروژه‌های کوچک
                                                                                                                                                                                    • ☰ 17.1. بازی حدس عدد
                                                                                                                                                                                      • ☰ 17.2. ماشین‌حساب ساده
                                                                                                                                                                                        • ☰ 17.3. فهرست کارها (To-Do List)
                                                                                                                                                                                          • ☰ 17.4. تولیدکنندهٔ رمز عبور
                                                                                                                                                                                            • ☰ 17.5. برنامهٔ آزمون (Quiz)
                                                                                                                                                                                              • ☰ 17.6. پروژهٔ کوچک وب یا داده
                                                                                                                                                                                              • ☰ 18. فصل ۱۸: گام‌های بعدی
                                                                                                                                                                                                • ☰ 18.1. چگونه پایتون را تمرین کنیم
                                                                                                                                                                                                  • ☰ 18.2. نوشتن کد تمیز و خوانا
                                                                                                                                                                                                    • ☰ 18.3. انتخاب یک حوزهٔ تخصصی
                                                                                                                                                                                                      • ☰ 18.3.1. توسعهٔ وب
                                                                                                                                                                                                        • ☰ 18.3.2. علم داده
                                                                                                                                                                                                          • ☰ 18.3.3. خودکارسازی
                                                                                                                                                                                                            • ☰ 18.3.4. توسعهٔ نرم‌افزار
                                                                                                                                                                                                            • ☰ 18.4. منابع یادگیری و انجمن‌ها
                                                                                                                                                                                                            • ☰ 19. پیوست
                                                                                                                                                                                                              • ☰ 19.1. برگهٔ تقلب دستور زبان پایتون
                                                                                                                                                                                                                • ☰ 19.2. خطاهای رایج و راه‌حل‌ها
                                                                                                                                                                                                                  • ☰ 19.3. واژه‌نامهٔ اصطلاحات