شروع کار با فالکون – قسمت اول: ساختار پوشه ها

در این مجموعه پست آموزشی قصد دارم در رابطه با ساختن اولین پروژه و چاپ کردن Hello World در فالکون توضیحاتی بدم.

اولین قسمت این آموزش درباره ساختار پوشه هاست.

نکته اول که باید اشاره کنم اینه که فالکون مانند فریم ورک های دیگه استراکچر خاصی برای فایل ها نداره. این به این معنی هست که شما میتونید پوشه بندی و ساختار فایل های پروژه تون رو خودتون تعیین کنید. همچنین فالکون برای خودش هیچ فایلی نداره. چون تمام فایل های این فریم ورک روی سرور نصب میشن. میتونید نصب فالکون روی سرور رو از اینجا یاد بگیرید.

نکته دوم هم اینه که فالکون ذاتا از معماری MVC پشتیبانی میکنه. ولی شما میتونید از این معماری استفاده نکنید.

پیشنهاد من که برگرفته از پروژه های سمپل خود فالکون هست، استراکچر فایل رو به صورت زیر ایجاد کرده:

app/
    cache/
    config/
    controller/
    library/
    models/
    views/ 
public_html/
    assets/
    uploads/

این ساختار پوشه کاملا پیشنهادیه و شما میتونید ساختار و استراکچر خودتون رو داشته باشید.

توضیحات مربوط به هر پوشه:

در کل ما دو پوشه app و public_html داریم که کل پروژه در این دو پوشه قرار میگیرند.

پوشه cache:

قرار نیست اتفاق خاصی داخل این پوشه بیوفته. این پوشه برای اینه که چیزایی که میخاید کش کنید در این جا قرار بگیرند.

پوشه config:

در این پوشه من معمولا فایل کانفیگ و فایل مربوط به router رو ذخیره میکنم. پس دو فایل config.ini و router.php رو داخل این پوشه میزاریم.

پوشه controller:

همون طور که از اسمش پیداس همه فایل های کنترلر ها در این پوشه قرار میگیرن.

پوشه library:

معمولا همه ما یک سری کلاس هایی داریم که در هین پروژه مرتبا باید ازشون استفاده کنیم. مثلا برای من کتابخونه تقویم فارسی از سالار کابلی همیشه توی پروژه م هست.

پوشه models:

این هم همون طور که از اسمش پیداس پوشه ایه که مدل های پروژه درش قرار میگیرن. (مدل هایی که شما از ساختار موجودیت های دیتابیس تون دارید.)

پوشه views:

این پوشه رو استفاده میکنیم تا فایل های مربوط به view رو داخلش بریزیم. ما توی فالکون میتونیم هر تمپلیت انجینی که خواستیم استفاده کنیم. ولی تمپلیت انجین خود فالکون volt هستش. البته میتونید از phtml هم بای دیفالت استفاده کنید.

پوشه public_html:

اگر با هاست های لینوکسی و cpanel کار کرده باشید قطعا با اسم این پوشه آشنا هستید.

این پوشه پوشه ای هست که به صورت پیش فرض توسط وبسرویس اجرا میشه. یعنی که چیز هایی که شما از طریق آدرس وبسایت بهشون دسترسی دارید داخل این پوشه باید باشن.

مهم ترین فایلی که داخل این پوشه هست، فایل index.php هست که برای هر درخواستی که به سرور ارسال میشه این فایل اجرا میشه. در ادامه در مورد چیزایی که باید داخل این فایل باشن توضیح میدم.

پوشه assets:

معمولا پروژه ها یک سری فایل css و js و … دارن که باید سمت کاربر لود بشن. معمولا این فایل ها رو داخل این پوشه میریزیم.

پوشه uploads:

اگر کاریران سایت شما باید امکان آپلود کردن فایل در سایت داشته باشن باید برای فایل های آپلود شده فضایی رو در نظر بگیریم که این پوشه ست.