<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>بایگانی‌های لاراول 13 | نوین هاب</title>
	<atom:link href="https://tarahanenovin.ir/blog/tag/%d9%84%d8%a7%d8%b1%d8%a7%d9%88%d9%84-13/feed/" rel="self" type="application/rss+xml" />
	<link>https://tarahanenovin.ir/blog/tag/لاراول-13/</link>
	<description>بلاگ طراحان نوین</description>
	<lastBuildDate>Thu, 30 Jul 2026 14:39:14 +0000</lastBuildDate>
	<language>fa-IR</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	<generator>https://wordpress.org/?v=7.0.2</generator>
	<item>
		<title>تمامی چیزهایی که باید درباره Laravel 13 بدانید</title>
		<link>https://tarahanenovin.ir/blog/%d8%aa%d9%85%d8%a7%d9%85%db%8c-%da%86%db%8c%d8%b2%d9%87%d8%a7%db%8c%db%8c-%da%a9%d9%87-%d8%a8%d8%a7%db%8c%d8%af-%d8%af%d8%b1%d8%a8%d8%a7%d8%b1%d9%87-laravel-13-%d8%a8%d8%af%d8%a7%d9%86%db%8c%d8%af/</link>
					<comments>https://tarahanenovin.ir/blog/%d8%aa%d9%85%d8%a7%d9%85%db%8c-%da%86%db%8c%d8%b2%d9%87%d8%a7%db%8c%db%8c-%da%a9%d9%87-%d8%a8%d8%a7%db%8c%d8%af-%d8%af%d8%b1%d8%a8%d8%a7%d8%b1%d9%87-laravel-13-%d8%a8%d8%af%d8%a7%d9%86%db%8c%d8%af/#respond</comments>
		
		<dc:creator><![CDATA[TNVN]]></dc:creator>
		<pubDate></pubDate>
				<category><![CDATA[برنامه نویسی]]></category>
		<category><![CDATA[بک‌اند]]></category>
		<category><![CDATA[طراحی وب]]></category>
		<category><![CDATA[فرانت‌اند]]></category>
		<category><![CDATA[Laravel]]></category>
		<category><![CDATA[لاراول]]></category>
		<category><![CDATA[لاراول 13]]></category>
		<guid isPermaLink="false">https://tarahanenovin.ir/blog/?p=230</guid>

					<description><![CDATA[<p>لاراول 13 نسل ۲۰۲۶ این فریم ورک است که طبق ریلیز نوت رسمی، تمرکز اصلی اش روی «AI-native workflows»، پیش فرض های امن تر، و APIهای بیانگرتر است؛ در عین حال طبق راهنمای ارتقا، برای اکثر پروژه ها یک ارتقای کم دردسر و سریع محسوب می شود. Laravel 13 دقیقا چیست و چرا مهم است؟ Laravel 13 ادامه روند انتشار سالانه لاراول است و چند پیام واضح دارد: حداقل PHP 8.3: یعنی اگر پروژه شما روی 8.2 یا پایین تر است، قبل از هر کاری باید زیرساخت اجرا را آماده کنید. AI به صورت رسمی و First-party: یعنی برای کارهای رایج هوش مصنوعی (تولید متن، تصویر، امبدینگ، agentها و…) دیگر لازم نیست همیشه از چند پکیج پراکنده استفاده کنید. امنیت با پیش فرض های سخت گیرانه تر: مخصوصا در بحث cache serialization و میان افزار جدید جلوگیری از جعل درخواست. کمترین Breaking Change: تیم لاراول عمدا تلاش کرده ارتقای 12 به 13 سریع باشد (در خود آپگرید گاید زمان تخمینی حدود ۱۰ دقیقه ذکر شده). نسخه ها، پشتیبانی و نیازمندی ها (آن چیزی که قبل از کدنویسی باید بدانید) 1) سیاست نسخه بندی و سازگاری لاراول از Semantic Versioning پیروی می کند: Major (مثل 12 → 13) می تواند Breaking Change داشته باشد. Minor/Patch نباید Breaking Change داشته باشند. نکته حرفه ای: در composer.json بهتر است constraintها را به شکل ^13.0 تنظیم کنید تا آپدیت های Minor/Patch را بدون درگیری بگیرید. 2) حداقل PHP طبق مستندات رسمی: Laravel 13.x حداقل PHP 8.3 می خواهد. این یعنی: سرور، لوکال، CI و حتی imageهای Docker باید همگی هم راستا شوند. پکیج های قدیمی که PHP 8.3 را ساپورت نمی کنند، اولین منبع دردسر شما خواهند بود (نه خود لاراول). مهم ترین قابلیت های جدید Laravel 13 (با نگاه عملی) 1) Laravel AI SDK (هسته AI به صورت رسمی) لاراول 13 یک SDK رسمی برای AI معرفی کرده که هدفش این است: شما یک API لاراولی و provider-agnostic داشته باشید. بعدا اگر provider را عوض کردید (یا چند provider داشتید)، کدتان به هم نریزد. کارهای رایج: text generation, tool-calling agents, embeddings, audio, image و یکپارچه سازی با vector store. مدل ذهنی (چطور به آن نگاه کنیم؟) AI SDK را مثل این ببینید: Service جدید در لایه infrastructure با قراردادهای مشخص و façade / entrypointهای تمیز برای use-caseهای مختلف مثال ها (از ریلیز نوت) تولید پاسخ با یک agent: use App\Ai\Agents\SalesCoach; $response = SalesCoach::make()-&#62;prompt('Analyze this sales transcript...'); return (string) $response; تولید تصویر: use Laravel\Ai\Image; $image = Image::of('A donut sitting on the kitchen counter')-&#62;generate(); $rawContent = (string) $image; تولید صوت: use Laravel\Ai\Audio; $audio = Audio::of('I love coding with Laravel.')-&#62;generate(); $rawContent = (string) $audio; تولید امبدینگ (برای semantic search / RAG): use Illuminate\Support\Str; $embeddings = Str::of('Napa Valley has great wine.')-&#62;toEmbeddings(); نکات معماری برای پروژه واقعی برای تولید امبدینگ، صف (Queue) بگذارید: هم هزینه کنترل می شود، هم UX بهتر است. نتیجه امبدینگ را در یک vector store (یا دیتابیس مناسب) ذخیره کنید و برای جستجوی معنایی استفاده کنید. خروجی AI را مثل input کاربر «غیرقابل اعتماد» فرض کنید: validate، sanitize و محدودیت دسترسی اعمال کنید. 2) JSON:API Resources (خروجی استاندارد API) لاراول 13 JSON:API resources را به صورت First-party اضافه کرده است تا: ساختار response مطابق استاندارد JSON:API باشد مدیریت relationshipها، includeها، sparse fieldsetها، links و headerهای استاندارد ساده شود. چرا این برای تیم های حرفه ای مهم است؟ چون در APIهای بزرگ: یک استاندارد خروجی، هزینه هماهنگی frontend/backend را کم می کند. و با رشد پروژه، consistency حفظ می شود. 3) PreventRequestForgery (تقویت CSRF / جعل درخواست) در لاراول 13، میان افزار حفاظت از جعل درخواست formalized و بهتر شده و با نام: PreventRequestForgery ارائه شده و origin-aware request verification را اضافه می کند در کنار سازگاری با توکن CSRF. نکته امنیتی اگر با چند subdomain، reverse proxy، یا SPA روی دامنه جدا کار می کنید: حتما رفتار originها و headerها را در staging تست کنید. چون تغییرات امنیتی معمولا روی محیط های واقعی (CDN/WAF) خودش را نشان می دهد. 4) Queue Routing (مسیر دهی صف بر اساس کلاس Job) لاراول 13 امکان route کردن jobها را به شکل مرکزی اضافه کرده: Queue::route(ProcessPodcast::class, connection: 'redis', queue: 'podcasts'); چرا این عالی است؟ در پروژه های بزرگ معمولا این درد را دارید: بعضی jobها باید سریع اجرا شوند (queue جدا) بعضی jobها heavy هستند (worker جدا) بعضی jobها IO bound هستند (connection جدا) با route مرکزی: از پخش شدن -&#62;onQueue() و -&#62;onConnection() در کل کد جلوگیری می کنید. معماری queue تمیزتر می شود. 5) گسترش PHP Attributes (اعلان محور شدن رفتارها) لاراول 13 پشتیبانی attributeها را در بخش های بیشتری گسترش داده؛ نمونه هایی که در ریلیز نوت آمده: #[Middleware] #[Authorize] و برای jobها: #[Tries], #[Backoff], #[Timeout], #[FailOnTimeout] مثال: use App\Models\Comment; use App\Models\Post; use Illuminate\Routing\Attributes\Controllers\Authorize; use Illuminate\Routing\Attributes\Controllers\Middleware; #[Middleware('auth')] class CommentController { #[Middleware('subscribed')] #[Authorize('create', [Comment::class, 'post'])] public function store(Post $post) { // ... } } نگاه مهندسی Attributes یعنی: رفتار نزدیک کد قرار می گیرد (co-located) readability بالا می رود اما باید مراقب باشید config پراکنده و غیرقابل جستجو نشود پیشنهاد تیمی: برای پروژه های بزرگ، یک convention داخلی تعیین کنید: چه چیزهایی attribute و چه چیزهایی config. 6) Cache::touch و تغییرات مهم Cache Serialization Cache::touch Laravel 13 متدی اضافه کرده که TTL یک آیتم cache را بدون re-store کردن مقدار تمدید می کند: Cache::touch(...) این در سناریوهایی مثل sliding expiration خیلی کاربردی است. سخت گیری امنیتی: serializable_classes در آپگرید گاید آمده: مقدار پیش فرض serializable_classes در config cache روی false قرار گرفته تا ریسک حملات deserialization کاهش یابد (خصوصا اگر APP_KEY لو برود). اگر شما عمدا object در cache می گذارید: باید allow-list کلاس ها را مشخص کنید. نکته: در سیستم های بزرگ بهتر است payload cache را array/JSON نگه دارید نه object؛ چون: نسخه بندی ساده تر می شود ریسک امنیتی کمتر می شود وابستگی به ساختار کلاس کاهش می یابد ارتقا به Laravel 13 از Laravel 12 طبق Upgrade Guide رسمی، زمان تخمینی ارتقا حدود ۱۰ دقیقه است (اگر پروژه خیلی خاص نباشد). اما در عمل برای تیم های حرفه ای، مسیر درست این است: گام 1: آماده سازی (قبل از composer update) PHP را روی همه محیط ها به 8.3 ارتقا دهید (لوکال، CI، سرور). یک Branch جدا برای upgrade بسازید. تست ها را سبز کنید (اگر تست ندارید، حداقل smoke test بنویسید: لاگین، CRUD اصلی، queue worker). گام 2: آپدیت وابستگی ها طبق مستندات: laravel/framework → ^13.0 laravel/boost → ^2.0 laravel/tinker → ^3.0 phpunit/phpunit → ^12.0 pestphp/pest → ^4.0 سپس: composer update و رفع تعارض پکیج ها (معمولا اصلی ترین قسمت کار همین است) گام 3: بررسی High Impact Changes Request Forgery Protection: رفتار originها و CSRF را در محیط واقعی تست کنید. Cache serialization: اگر object cache می کنید، سریع تکلیف serializable_classes را مشخص کنید. گام 4: بررسی Medium/Low Impact از مواردی که در Upgrade Guide ذکر شده: تغییر پیش فرض prefixهای cache و session cookie (اگر به fallbackهای framework متکی بودید) تغییر رفتار Container::call در پارامتر nullable با default null موارد مرتبط با MySQL در برخی queryهای DELETE با JOIN/ORDER/LIMIT (برای سیستم های قدیمی ممکن است مهم شود) ارتقا با AI (رویکرد جدید تیم لاراول) Laravel 13 پیشنهاد می دهد از Laravel Boost به عنوان MCP server استفاده کنید و با یک slash command فرایند ارتقا را هدایت کنید: دستور /upgrade-laravel-v13 نیازمند laravel/boost ^2.0 این برای تیم هایی عالی است که: کدبیس بزرگ دارند می خواهند checklist ارتقا را سریع و با کمترین خطا جلو ببرند اما باز هم باید خروجی را review کنید (AI جای review را نمی گیرد) نصب و راه اندازی Laravel 13 (برای پروژه جدید) از Installation رسمی: نیاز دارید PHP + Composer + Laravel Installer و برای assetها: Node/NPM یا Bun در تیم های حرفه ای پیشنهاد می کنم: روی لوکال از ابزارهای رسمی مثل Herd (در صورت امکان) یا Docker استفاده کنید روی CI یک matrix ساده بسازید (PHP 8.3 + DB) از همان اول queue و scheduler را جدا طراحی کنید نکات معماری و Best Practice برای Laravel 13 1) AI را Feature محور پیاده کنید، نه هیجانی به جای اینکه «AI را همه جا بریزید»، use-case تعریف کنید: جستجوی معنایی محصولات خلاصه سازی تیکت های پشتیبانی پیشنهاد پاسخ برای اپراتور دسته بندی خودکار محتوا هر use-case: ورودی مشخص خروجی مشخص logging و monitoring fallback (اگر provider قطع شد) 2) Queue-first برای کارهای AI و پردازش سنگین هر چیزی که: IO زیاد دارد هزینه دارد یا latency بالا دارد باید برود صف. بعد route کردن صف ها در Laravel 13 تمیزتر هم شده است. 3) امنیت Cache را جدی بگیرید اگر قبلا هر چیزی را object می کردید و می گذاشتید cache: الان وقت refactor است یا allow-list دقیق بنویسید 4) از استاندارد JSON:API برای تیم های چندکلاینتی استفاده کنید اگر شما: وب + اپ موبایل + پنل جدا دارید JSON:API می تواند استاندارد مشترک خروجی باشد. جمع بندی Laravel 13 یک ارتقای کم ریسک اما بسیار مهم است: حداقل PHP 8.3، SDK رسمی AI، استانداردسازی بهتر APIها با JSON:API، بهبودهای امنیتی مثل PreventRequestForgery و سخت گیری در unserialize شدن cache، و همچنین کیفیت زندگی بهتر در صف ها با Queue routing و Attributeهای بیشتر. اگر پروژه شما Laravel 12 است، بهترین مسیر این است: PHP 8.3 را آماده کنید وابستگی ها را طبق Upgrade Guide بالا ببرید موارد امنیتی cache و CSRF را در staging تست کنید سپس release کنید اگر قصد طراحی سایت یا توسعه وب اپلیکیشن با Laravel 13 را دارید و می خواهید معماری پروژه از ابتدا اصولی، امن و قابل توسعه باشد، از طریق صفحه تماس با ما با طراحان نوین در ارتباط باشید تا نیاز پروژه را بررسی و مسیر اجرای درست را پیشنهاد کنیم.</p>
<p>نوشته <a href="https://tarahanenovin.ir/blog/%d8%aa%d9%85%d8%a7%d9%85%db%8c-%da%86%db%8c%d8%b2%d9%87%d8%a7%db%8c%db%8c-%da%a9%d9%87-%d8%a8%d8%a7%db%8c%d8%af-%d8%af%d8%b1%d8%a8%d8%a7%d8%b1%d9%87-laravel-13-%d8%a8%d8%af%d8%a7%d9%86%db%8c%d8%af/">تمامی چیزهایی که باید درباره Laravel 13 بدانید</a> اولین بار در <a href="https://tarahanenovin.ir/blog">نوین هاب</a>. پدیدار شد.</p>
]]></description>
										<content:encoded><![CDATA[<p dir="rtl" lang="fa"><strong>لاراول 13</strong> نسل ۲۰۲۶ این فریم ورک است که طبق ریلیز نوت رسمی، تمرکز اصلی اش روی «AI-native workflows»، پیش فرض های امن تر، و APIهای بیانگرتر است؛ در عین حال طبق راهنمای ارتقا، برای اکثر پروژه ها یک ارتقای کم دردسر و سریع محسوب می شود.</p>
<h2 dir="rtl" lang="fa">Laravel 13 دقیقا چیست و چرا مهم است؟</h2>
<p dir="rtl" lang="fa">Laravel 13 ادامه روند انتشار سالانه لاراول است و چند پیام واضح دارد:</p>
<ol dir="rtl" lang="fa">
<li><strong>حداقل PHP 8.3</strong>: یعنی اگر پروژه شما روی 8.2 یا پایین تر است، قبل از هر کاری باید زیرساخت اجرا را آماده کنید.</li>
<li><strong>AI به صورت رسمی و First-party</strong>: یعنی برای کارهای رایج هوش مصنوعی (تولید متن، تصویر، امبدینگ، agentها و…) دیگر لازم نیست همیشه از چند پکیج پراکنده استفاده کنید.</li>
<li><strong>امنیت با پیش فرض های سخت گیرانه تر</strong>: مخصوصا در بحث cache serialization و میان افزار جدید جلوگیری از جعل درخواست.</li>
<li><strong>کمترین Breaking Change</strong>: تیم لاراول عمدا تلاش کرده ارتقای 12 به 13 سریع باشد (در خود آپگرید گاید زمان تخمینی حدود ۱۰ دقیقه ذکر شده).</li>
</ol>
<h2 dir="rtl" lang="fa">نسخه ها، پشتیبانی و نیازمندی ها (آن چیزی که قبل از کدنویسی باید بدانید)</h2>
<h3 dir="rtl" lang="fa">1) سیاست نسخه بندی و سازگاری</h3>
<p dir="rtl" lang="fa">لاراول از <strong>Semantic Versioning</strong> پیروی می کند:</p>
<ul dir="rtl" lang="fa">
<li>Major (مثل 12 → 13) می تواند Breaking Change داشته باشد.</li>
<li>Minor/Patch نباید Breaking Change داشته باشند.</li>
</ul>
<p dir="rtl" lang="fa">نکته حرفه ای: در <code>composer.json</code> بهتر است constraintها را به شکل <code>^13.0</code> تنظیم کنید تا آپدیت های Minor/Patch را بدون درگیری بگیرید.</p>
<h3 dir="rtl" lang="fa">2) حداقل PHP</h3>
<p dir="rtl" lang="fa">طبق مستندات رسمی:</p>
<ul dir="rtl" lang="fa">
<li><strong>Laravel 13.x حداقل PHP 8.3 می خواهد</strong>.</li>
</ul>
<p dir="rtl" lang="fa">این یعنی:</p>
<ul dir="rtl" lang="fa">
<li>سرور، لوکال، CI و حتی imageهای Docker باید همگی هم راستا شوند.</li>
<li>پکیج های قدیمی که PHP 8.3 را ساپورت نمی کنند، اولین منبع دردسر شما خواهند بود (نه خود لاراول).</li>
</ul>
<h2 dir="rtl" lang="fa">مهم ترین قابلیت های جدید Laravel 13 (با نگاه عملی)</h2>
<h2 dir="rtl" lang="fa">1) Laravel AI SDK (هسته AI به صورت رسمی)</h2>
<p dir="rtl" lang="fa">لاراول 13 یک SDK رسمی برای AI معرفی کرده که هدفش این است:</p>
<ul dir="rtl" lang="fa">
<li>شما یک API لاراولی و provider-agnostic داشته باشید.</li>
<li>بعدا اگر provider را عوض کردید (یا چند provider داشتید)، کدتان به هم نریزد.</li>
<li>کارهای رایج: <strong>text generation</strong>, <strong>tool-calling agents</strong>, <strong>embeddings</strong>, <strong>audio</strong>, <strong>image</strong> و یکپارچه سازی با vector store.</li>
</ul>
<h3 dir="rtl" lang="fa">مدل ذهنی (چطور به آن نگاه کنیم؟)</h3>
<p dir="rtl" lang="fa">AI SDK را مثل این ببینید:</p>
<ul dir="rtl" lang="fa">
<li><code>Service</code> جدید در لایه infrastructure</li>
<li>با قراردادهای مشخص</li>
<li>و façade / entrypointهای تمیز برای use-caseهای مختلف</li>
</ul>
<h3 dir="rtl" lang="fa">مثال ها (از ریلیز نوت)</h3>
<p dir="rtl" lang="fa">تولید پاسخ با یک agent:</p>
<pre><code class="hljs"><span class="hljs-keyword">use</span> <span class="hljs-title">App</span>\<span class="hljs-title">Ai</span>\<span class="hljs-title">Agents</span>\<span class="hljs-title">SalesCoach</span>;

<span class="hljs-variable">$response</span> = <span class="hljs-title class_">SalesCoach</span>::<span class="hljs-title function_ invoke__">make</span>()-&gt;<span class="hljs-title function_ invoke__">prompt</span>(<span class="hljs-string">'Analyze this sales transcript...'</span>);

<span class="hljs-keyword">return</span> (<span class="hljs-keyword">string</span>) <span class="hljs-variable">$response</span>;
</code></pre>
<p dir="rtl" lang="fa">تولید تصویر:</p>
<pre><code class="hljs"><span class="hljs-keyword">use</span> <span class="hljs-title">Laravel</span>\<span class="hljs-title">Ai</span>\<span class="hljs-title">Image</span>;

<span class="hljs-variable">$image</span> = <span class="hljs-title class_">Image</span>::<span class="hljs-title function_ invoke__">of</span>(<span class="hljs-string">'A donut sitting on the kitchen counter'</span>)-&gt;<span class="hljs-title function_ invoke__">generate</span>();
<span class="hljs-variable">$rawContent</span> = (<span class="hljs-keyword">string</span>) <span class="hljs-variable">$image</span>;
</code></pre>
<p dir="rtl" lang="fa">تولید صوت:</p>
<pre><code class="hljs"><span class="hljs-keyword">use</span> <span class="hljs-title">Laravel</span>\<span class="hljs-title">Ai</span>\<span class="hljs-title">Audio</span>;

<span class="hljs-variable">$audio</span> = <span class="hljs-title class_">Audio</span>::<span class="hljs-title function_ invoke__">of</span>(<span class="hljs-string">'I love coding with Laravel.'</span>)-&gt;<span class="hljs-title function_ invoke__">generate</span>();
<span class="hljs-variable">$rawContent</span> = (<span class="hljs-keyword">string</span>) <span class="hljs-variable">$audio</span>;
</code></pre>
<p dir="rtl" lang="fa">تولید امبدینگ (برای semantic search / RAG):</p>
<pre><code class="hljs"><span class="hljs-keyword">use</span> <span class="hljs-title">Illuminate</span>\<span class="hljs-title">Support</span>\<span class="hljs-title">Str</span>;

<span class="hljs-variable">$embeddings</span> = <span class="hljs-title class_">Str</span>::<span class="hljs-title function_ invoke__">of</span>(<span class="hljs-string">'Napa Valley has great wine.'</span>)-&gt;<span class="hljs-title function_ invoke__">toEmbeddings</span>();
</code></pre>
<h3 dir="rtl" lang="fa">نکات معماری برای پروژه واقعی</h3>
<ul dir="rtl" lang="fa">
<li>برای تولید امبدینگ، <strong>صف (Queue)</strong> بگذارید: هم هزینه کنترل می شود، هم UX بهتر است.</li>
<li>نتیجه امبدینگ را در یک vector store (یا دیتابیس مناسب) ذخیره کنید و برای جستجوی معنایی استفاده کنید.</li>
<li>خروجی AI را مثل input کاربر «غیرقابل اعتماد» فرض کنید: validate، sanitize و محدودیت دسترسی اعمال کنید.</li>
</ul>
<h2 dir="rtl" lang="fa">2) JSON:API Resources (خروجی استاندارد API)</h2>
<p dir="rtl" lang="fa">لاراول 13 <strong>JSON:API resources</strong> را به صورت First-party اضافه کرده است تا:</p>
<ul dir="rtl" lang="fa">
<li>ساختار response مطابق استاندارد JSON:API باشد</li>
<li>مدیریت relationshipها، includeها، sparse fieldsetها، links و headerهای استاندارد ساده شود.</li>
</ul>
<h3 dir="rtl" lang="fa">چرا این برای تیم های حرفه ای مهم است؟</h3>
<p dir="rtl" lang="fa">چون در APIهای بزرگ:</p>
<ul dir="rtl" lang="fa">
<li>یک استاندارد خروجی، هزینه هماهنگی frontend/backend را کم می کند.</li>
<li>و با رشد پروژه، consistency حفظ می شود.</li>
</ul>
<h2 dir="rtl" lang="fa">3) PreventRequestForgery (تقویت CSRF / جعل درخواست)</h2>
<p dir="rtl" lang="fa">در لاراول 13، میان افزار حفاظت از جعل درخواست formalized و بهتر شده و با نام:</p>
<ul dir="ltr" lang="en">
<li><code>PreventRequestForgery</code></li>
</ul>
<p dir="rtl" lang="fa">ارائه شده و <strong>origin-aware request verification</strong> را اضافه می کند در کنار سازگاری با توکن CSRF.</p>
<h3 dir="rtl" lang="fa">نکته امنیتی</h3>
<p dir="rtl" lang="fa">اگر با چند subdomain، reverse proxy، یا SPA روی دامنه جدا کار می کنید:</p>
<ul dir="rtl" lang="fa">
<li>حتما رفتار originها و headerها را در staging تست کنید.</li>
<li>چون تغییرات امنیتی معمولا روی محیط های واقعی (CDN/WAF) خودش را نشان می دهد.</li>
</ul>
<h2 dir="rtl" lang="fa">4) Queue Routing (مسیر دهی صف بر اساس کلاس Job)</h2>
<p dir="rtl" lang="fa">لاراول 13 امکان route کردن jobها را به شکل مرکزی اضافه کرده:</p>
<pre><code class="hljs"><span class="hljs-title class_">Queue</span>::<span class="hljs-title function_ invoke__">route</span>(<span class="hljs-title class_">ProcessPodcast</span>::<span class="hljs-variable language_">class</span>, <span class="hljs-attr">connection</span>: <span class="hljs-string">'redis'</span>, <span class="hljs-attr">queue</span>: <span class="hljs-string">'podcasts'</span>);
</code></pre>
<h3 dir="rtl" lang="fa">چرا این عالی است؟</h3>
<p dir="rtl" lang="fa">در پروژه های بزرگ معمولا این درد را دارید:</p>
<ul dir="rtl" lang="fa">
<li>بعضی jobها باید سریع اجرا شوند (queue جدا)</li>
<li>بعضی jobها heavy هستند (worker جدا)</li>
<li>بعضی jobها IO bound هستند (connection جدا)</li>
</ul>
<p dir="rtl" lang="fa">با route مرکزی:</p>
<ul dir="rtl" lang="fa">
<li>از پخش شدن <code>-&gt;onQueue()</code> و <code>-&gt;onConnection()</code> در کل کد جلوگیری می کنید.</li>
<li>معماری queue تمیزتر می شود.</li>
</ul>
<h2 dir="rtl" lang="fa">5) گسترش PHP Attributes (اعلان محور شدن رفتارها)</h2>
<p dir="rtl" lang="fa">لاراول 13 پشتیبانی attributeها را در بخش های بیشتری گسترش داده؛ نمونه هایی که در ریلیز نوت آمده:</p>
<ul dir="ltr" lang="en">
<li><code>#[Middleware]</code></li>
<li><code>#[Authorize]</code></li>
<li>و برای jobها: <code>#[Tries]</code>, <code>#[Backoff]</code>, <code>#[Timeout]</code>, <code>#[FailOnTimeout]</code></li>
</ul>
<p dir="rtl" lang="fa">مثال:</p>
<pre><code class="hljs"><span class="hljs-keyword">use</span> <span class="hljs-title">App</span>\<span class="hljs-title">Models</span>\<span class="hljs-title">Comment</span>;
<span class="hljs-keyword">use</span> <span class="hljs-title">App</span>\<span class="hljs-title">Models</span>\<span class="hljs-title">Post</span>;
<span class="hljs-keyword">use</span> <span class="hljs-title">Illuminate</span>\<span class="hljs-title">Routing</span>\<span class="hljs-title">Attributes</span>\<span class="hljs-title">Controllers</span>\<span class="hljs-title">Authorize</span>;
<span class="hljs-keyword">use</span> <span class="hljs-title">Illuminate</span>\<span class="hljs-title">Routing</span>\<span class="hljs-title">Attributes</span>\<span class="hljs-title">Controllers</span>\<span class="hljs-title">Middleware</span>;

<span class="hljs-meta">#[Middleware</span>(<span class="hljs-string">'auth'</span>)<span class="hljs-meta">]</span>
<span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">CommentController</span>
</span>{
    <span class="hljs-meta">#[Middleware</span>(<span class="hljs-string">'subscribed'</span>)<span class="hljs-meta">]</span>
    <span class="hljs-meta">#[Authorize</span>(<span class="hljs-string">'create'</span>, [<span class="hljs-title class_">Comment</span>::<span class="hljs-variable language_">class</span>, <span class="hljs-string">'post'</span>])<span class="hljs-meta">]</span>
    <span class="hljs-keyword">public</span> <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">store</span>(<span class="hljs-params">Post <span class="hljs-variable">$post</span></span>)
    </span>{
        <span class="hljs-comment">// ...</span>
    }
}
</code></pre>
<h3 dir="rtl" lang="fa">نگاه مهندسی</h3>
<p dir="rtl" lang="fa">Attributes یعنی:</p>
<ul dir="rtl" lang="fa">
<li>رفتار نزدیک کد قرار می گیرد (co-located)</li>
<li>readability بالا می رود</li>
<li>اما باید مراقب باشید config پراکنده و غیرقابل جستجو نشود</li>
</ul>
<p dir="rtl" lang="fa">پیشنهاد تیمی:</p>
<ul dir="rtl" lang="fa">
<li>برای پروژه های بزرگ، یک convention داخلی تعیین کنید: چه چیزهایی attribute و چه چیزهایی config.</li>
</ul>
<h2 dir="rtl" lang="fa">6) Cache::touch و تغییرات مهم Cache Serialization</h2>
<h3 lang="en">Cache::touch</h3>
<p dir="rtl" lang="fa">Laravel 13 متدی اضافه کرده که TTL یک آیتم cache را بدون re-store کردن مقدار تمدید می کند:</p>
<ul dir="ltr" lang="en">
<li><code>Cache::touch(...)</code></li>
</ul>
<p dir="rtl" lang="fa">این در سناریوهایی مثل sliding expiration خیلی کاربردی است.</p>
<h3 dir="rtl" lang="fa">سخت گیری امنیتی: <code>serializable_classes</code></h3>
<p dir="rtl" lang="fa">در آپگرید گاید آمده:</p>
<ul dir="rtl" lang="fa">
<li>مقدار پیش فرض <code>serializable_classes</code> در config cache روی <code>false</code> قرار گرفته تا <strong>ریسک حملات deserialization</strong> کاهش یابد (خصوصا اگر <code>APP_KEY</code> لو برود).</li>
</ul>
<p dir="rtl" lang="fa">اگر شما عمدا object در cache می گذارید:</p>
<ul dir="rtl" lang="fa">
<li>باید allow-list کلاس ها را مشخص کنید.</li>
</ul>
<p dir="rtl" lang="fa">نکته: در سیستم های بزرگ بهتر است <strong>payload cache را array/JSON نگه دارید</strong> نه object؛ چون:</p>
<ul dir="rtl" lang="fa">
<li>نسخه بندی ساده تر می شود</li>
<li>ریسک امنیتی کمتر می شود</li>
<li>وابستگی به ساختار کلاس کاهش می یابد</li>
</ul>
<h1 dir="rtl" lang="fa">ارتقا به Laravel 13 از Laravel 12</h1>
<p dir="rtl" lang="fa">طبق Upgrade Guide رسمی، زمان تخمینی ارتقا <strong>حدود ۱۰ دقیقه</strong> است (اگر پروژه خیلی خاص نباشد). اما در عمل برای تیم های حرفه ای، مسیر درست این است:</p>
<h2 dir="rtl" lang="fa">گام 1: آماده سازی (قبل از composer update)</h2>
<ol dir="rtl" lang="fa">
<li>PHP را روی همه محیط ها به <strong>8.3</strong> ارتقا دهید (لوکال، CI، سرور).</li>
<li>یک Branch جدا برای upgrade بسازید.</li>
<li>تست ها را سبز کنید (اگر تست ندارید، حداقل smoke test بنویسید: لاگین، CRUD اصلی، queue worker).</li>
</ol>
<h2 dir="rtl" lang="fa">گام 2: آپدیت وابستگی ها</h2>
<p dir="rtl" lang="fa">طبق مستندات:</p>
<ul dir="ltr" lang="en">
<li><code>laravel/framework</code> → <code>^13.0</code></li>
<li><code>laravel/boost</code> → <code>^2.0</code></li>
<li><code>laravel/tinker</code> → <code>^3.0</code></li>
<li><code>phpunit/phpunit</code> → <code>^12.0</code></li>
<li><code>pestphp/pest</code> → <code>^4.0</code></li>
</ul>
<p dir="rtl" lang="fa">سپس:</p>
<ul dir="rtl" lang="fa">
<li><code>composer update</code></li>
<li>و رفع تعارض پکیج ها (معمولا اصلی ترین قسمت کار همین است)</li>
</ul>
<h2 dir="rtl" lang="fa">گام 3: بررسی High Impact Changes</h2>
<ul dir="rtl" lang="fa">
<li><strong>Request Forgery Protection</strong>: رفتار originها و CSRF را در محیط واقعی تست کنید.</li>
<li><strong>Cache serialization</strong>: اگر object cache می کنید، سریع تکلیف <code>serializable_classes</code> را مشخص کنید.</li>
</ul>
<h2 dir="rtl" lang="fa">گام 4: بررسی Medium/Low Impact</h2>
<p dir="rtl" lang="fa">از مواردی که در Upgrade Guide ذکر شده:</p>
<ul dir="rtl" lang="fa">
<li>تغییر پیش فرض prefixهای cache و session cookie (اگر به fallbackهای framework متکی بودید)</li>
<li>تغییر رفتار <code>Container::call</code> در پارامتر nullable با default null</li>
<li>موارد مرتبط با MySQL در برخی queryهای DELETE با JOIN/ORDER/LIMIT (برای سیستم های قدیمی ممکن است مهم شود)</li>
</ul>
<h2 dir="rtl" lang="fa">ارتقا با AI (رویکرد جدید تیم لاراول)</h2>
<p dir="rtl" lang="fa">Laravel 13 پیشنهاد می دهد از <strong>Laravel Boost</strong> به عنوان MCP server استفاده کنید و با یک slash command فرایند ارتقا را هدایت کنید:</p>
<ul dir="rtl" lang="fa">
<li>دستور <code>/upgrade-laravel-v13</code></li>
<li>نیازمند <code>laravel/boost ^2.0</code></li>
</ul>
<p dir="rtl" lang="fa">این برای تیم هایی عالی است که:</p>
<ul dir="rtl" lang="fa">
<li>کدبیس بزرگ دارند</li>
<li>می خواهند checklist ارتقا را سریع و با کمترین خطا جلو ببرند</li>
<li>اما باز هم باید خروجی را review کنید (AI جای review را نمی گیرد)</li>
</ul>
<h1 dir="rtl" lang="fa">نصب و راه اندازی Laravel 13 (برای پروژه جدید)</h1>
<p dir="rtl" lang="fa">از Installation رسمی:</p>
<ul dir="rtl" lang="fa">
<li>نیاز دارید PHP + Composer + Laravel Installer</li>
<li>و برای assetها: Node/NPM یا Bun</li>
</ul>
<p dir="rtl" lang="fa">در تیم های حرفه ای پیشنهاد می کنم:</p>
<ul dir="rtl" lang="fa">
<li>روی لوکال از ابزارهای رسمی مثل Herd (در صورت امکان) یا Docker استفاده کنید</li>
<li>روی CI یک matrix ساده بسازید (PHP 8.3 + DB)</li>
<li>از همان اول queue و scheduler را جدا طراحی کنید</li>
</ul>
<h1 dir="rtl" lang="fa">نکات معماری و Best Practice برای Laravel 13</h1>
<h2 dir="rtl" lang="fa">1) AI را Feature محور پیاده کنید، نه هیجانی</h2>
<p dir="rtl" lang="fa">به جای اینکه «AI را همه جا بریزید»، use-case تعریف کنید:</p>
<ul dir="rtl" lang="fa">
<li>جستجوی معنایی محصولات</li>
<li>خلاصه سازی تیکت های پشتیبانی</li>
<li>پیشنهاد پاسخ برای اپراتور</li>
<li>دسته بندی خودکار محتوا</li>
</ul>
<p dir="rtl" lang="fa">هر use-case:</p>
<ul dir="rtl" lang="fa">
<li>ورودی مشخص</li>
<li>خروجی مشخص</li>
<li>logging و monitoring</li>
<li>fallback (اگر provider قطع شد)</li>
</ul>
<h2 dir="rtl" lang="fa">2) Queue-first برای کارهای AI و پردازش سنگین</h2>
<p dir="rtl" lang="fa">هر چیزی که:</p>
<ul dir="rtl" lang="fa">
<li>IO زیاد دارد</li>
<li>هزینه دارد</li>
<li>یا latency بالا دارد</li>
</ul>
<p dir="rtl" lang="fa">باید برود صف. بعد route کردن صف ها در Laravel 13 تمیزتر هم شده است.</p>
<h2 dir="rtl" lang="fa">3) امنیت Cache را جدی بگیرید</h2>
<p dir="rtl" lang="fa">اگر قبلا هر چیزی را object می کردید و می گذاشتید cache:</p>
<ul dir="rtl" lang="fa">
<li>الان وقت refactor است</li>
<li>یا allow-list دقیق بنویسید</li>
</ul>
<h2 dir="rtl" lang="fa">4) از استاندارد JSON:API برای تیم های چندکلاینتی استفاده کنید</h2>
<p dir="rtl" lang="fa">اگر شما:</p>
<ul dir="rtl" lang="fa">
<li>وب + اپ موبایل + پنل جدا دارید</li>
</ul>
<p dir="rtl" lang="fa">JSON:API می تواند استاندارد مشترک خروجی باشد.</p>
<h2 dir="rtl" lang="fa">جمع بندی</h2>
<p dir="rtl" lang="fa">Laravel 13 یک ارتقای کم ریسک اما بسیار مهم است: حداقل PHP 8.3، SDK رسمی AI، استانداردسازی بهتر APIها با JSON:API، بهبودهای امنیتی مثل PreventRequestForgery و سخت گیری در unserialize شدن cache، و همچنین کیفیت زندگی بهتر در صف ها با Queue routing و Attributeهای بیشتر.</p>
<p dir="rtl" lang="fa">اگر پروژه شما Laravel 12 است، بهترین مسیر این است:</p>
<ol dir="rtl" lang="fa">
<li>PHP 8.3 را آماده کنید</li>
<li>وابستگی ها را طبق Upgrade Guide بالا ببرید</li>
<li>موارد امنیتی cache و CSRF را در staging تست کنید</li>
<li>سپس release کنید</li>
</ol>
<p dir="rtl" lang="fa">اگر قصد <strong>طراحی سایت یا توسعه وب اپلیکیشن با Laravel 13</strong> را دارید و می خواهید معماری پروژه از ابتدا اصولی، امن و قابل توسعه باشد، از طریق صفحه <a href="https://tarahanenovin.ir/site/contact" target="_blank" rel="nofollow noopener noreferrer">تماس با ما</a> با طراحان نوین در ارتباط باشید تا نیاز پروژه را بررسی و مسیر اجرای درست را پیشنهاد کنیم.</p>
<p>نوشته <a href="https://tarahanenovin.ir/blog/%d8%aa%d9%85%d8%a7%d9%85%db%8c-%da%86%db%8c%d8%b2%d9%87%d8%a7%db%8c%db%8c-%da%a9%d9%87-%d8%a8%d8%a7%db%8c%d8%af-%d8%af%d8%b1%d8%a8%d8%a7%d8%b1%d9%87-laravel-13-%d8%a8%d8%af%d8%a7%d9%86%db%8c%d8%af/">تمامی چیزهایی که باید درباره Laravel 13 بدانید</a> اولین بار در <a href="https://tarahanenovin.ir/blog">نوین هاب</a>. پدیدار شد.</p>
]]></content:encoded>
					
					<wfw:commentRss>https://tarahanenovin.ir/blog/%d8%aa%d9%85%d8%a7%d9%85%db%8c-%da%86%db%8c%d8%b2%d9%87%d8%a7%db%8c%db%8c-%da%a9%d9%87-%d8%a8%d8%a7%db%8c%d8%af-%d8%af%d8%b1%d8%a8%d8%a7%d8%b1%d9%87-laravel-13-%d8%a8%d8%af%d8%a7%d9%86%db%8c%d8%af/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
			</item>
		<item>
		<title>قبل از ارتقا به Laravel 13 این نکات را بدانید</title>
		<link>https://tarahanenovin.ir/blog/%d9%82%d8%a8%d9%84-%d8%a7%d8%b2-%d8%a7%d8%b1%d8%aa%d9%82%d8%a7-%d8%a8%d9%87-laravel-13-%d8%a7%db%8c%d9%86-%d9%86%da%a9%d8%a7%d8%aa-%d8%b1%d8%a7-%d8%a8%d8%af%d8%a7%d9%86%db%8c%d8%af/</link>
					<comments>https://tarahanenovin.ir/blog/%d9%82%d8%a8%d9%84-%d8%a7%d8%b2-%d8%a7%d8%b1%d8%aa%d9%82%d8%a7-%d8%a8%d9%87-laravel-13-%d8%a7%db%8c%d9%86-%d9%86%da%a9%d8%a7%d8%aa-%d8%b1%d8%a7-%d8%a8%d8%af%d8%a7%d9%86%db%8c%d8%af/#respond</comments>
		
		<dc:creator><![CDATA[TNVN]]></dc:creator>
		<pubDate></pubDate>
				<category><![CDATA[برنامه نویسی]]></category>
		<category><![CDATA[بک‌اند]]></category>
		<category><![CDATA[طراحی وب]]></category>
		<category><![CDATA[فرانت‌اند]]></category>
		<category><![CDATA[Laravel]]></category>
		<category><![CDATA[آپدیت لاراول]]></category>
		<category><![CDATA[بروز رسانی لاراول]]></category>
		<category><![CDATA[لاراول]]></category>
		<category><![CDATA[لاراول 13]]></category>
		<guid isPermaLink="false">https://tarahanenovin.ir/blog/?p=226</guid>

					<description><![CDATA[<p>اگر در حال برنامه ریزی برای ارتقا به Laravel 13 هستید، بهتر است قبل از هر اقدامی فقط به تغییر شماره نسخه نگاه نکنید. ارتقا فریم ورک در پروژه های واقعی، مخصوصا پروژه هایی که در حال سرویس دهی هستند، می تواند روی پکیج ها، ساختار کد، فرایند استقرار، تست ها و حتی عملکرد تیم توسعه اثر مستقیم بگذارد. به همین دلیل، قبل از ارتقا به Laravel 13 باید تصویر روشنی از وضعیت فعلی پروژه، وابستگی ها و ریسک های اجرایی داشته باشید. این مقاله با نگاه کاملا عملی نوشته شده است؛ یعنی اگر یک پروژه واقعی دارید و می خواهید تصمیم بگیرید که آیا الان زمان مناسبی برای ارتقا هست یا نه، این مطلب می تواند به شما کمک کند. چرا ارتقا به Laravel 13 فقط یک به روز رسانی ساده نیست؟ در پروژه های آزمایشی، ارتقا نسخه معمولا با چند تغییر محدود در composer.json و رفع چند خطا تمام می شود. اما در پروژه های واقعی شرایط متفاوت است. در عمل، شما فقط خود Laravel را ارتقا نمی دهید، بلکه زنجیره ای از بخش های زیر هم درگیر می شوند: نسخه PHP سرور پکیج های Composer کدهای سفارشی شده پروژه Middlewareها و Service Providerها تست های خودکار Docker یا تنظیمات محیط استقرار CI/CD صف ها، کرون جاب ها و سرویس های جانبی به همین دلیل، تصمیم برای ارتقا باید فنی، مرحله ای و همراه با ارزیابی ریسک باشد؛ نه صرفا به دلیل جدید بودن نسخه. قبل از هر چیز، مطمئن شوید Laravel 13 واقعا برای پروژه شما لازم است یکی از اشتباه های رایج این است که فقط چون نسخه جدید منتشر شده، تیم توسعه بلافاصله به فکر مهاجرت می افتد. در حالی که در بسیاری از پروژه ها، ارتقا زمانی منطقی است که حداقل یکی از شرایط زیر وجود داشته باشد: پروژه به قابلیت های جدید نسخه جدید نیاز دارد نسخه فعلی شما به پایان پشتیبانی نزدیک شده است بعضی پکیج های مهم فقط با نسخه های جدید سازگارند تیم می خواهد بدهی فنی پروژه را کاهش دهد زیرساخت و استانداردهای توسعه در حال بازبینی هستند اگر هیچ کدام از این موارد وجود ندارد و پروژه پایدار است، شاید بهتر باشد ابتدا روی تست، مستندسازی و بهینه سازی کد تمرکز کنید. در همین زمینه، اگر به موضوع زیرساخت و استقرار استاندارد علاقه دارید، مطالعه مقاله آموزش Docker از صفر تا اجرای پروژه واقعی با داکر هم می تواند برای آماده سازی محیط ارتقا مفید باشد. مهم ترین بررسی ها قبل از ارتقا به Laravel 13 1) وضعیت نسخه فعلی پروژه را دقیق ثبت کنید قبل از هر کاری، باید بدانید الان دقیقا در چه نقطه ای هستید. فقط دانستن اینکه پروژه مثلا Laravel 10 یا 11 است کافی نیست. موارد زیر را مستند کنید: نسخه دقیق Laravel نسخه PHP در لوکال، staging و production لیست تمام پکیج های Composer پکیج های اختصاصی یا fork شده ابزارهای فرانت اند مثل Vite، Node.js و NPM ساختار تست ها تنظیمات queue، cache، session و mail روش deploy فعلی این مرحله به ظاهر ساده است، اما در عمل باعث می شود بعدا با خطاهای غیرمنتظره غافلگیر نشوید. 2) Release Note و Upgrade Guide را خط به خط بخوانید بزرگ ترین اشتباه در ارتقا این است که توسعه دهنده مستقیما سراغ تغییر نسخه برود و بعد شروع به رفع خطا کند. روش حرفه ای این است که ابتدا مستندات رسمی Laravel برای نسخه جدید را کامل بررسی کنید. هنگام مطالعه Upgrade Guide به این موارد توجه ویژه داشته باشید: Breaking Changeها تغییرات مربوط به routing تغییرات Eloquent تغییرات validation تغییرات queue و jobها حذف شدن helperها یا APIهای قدیمی تغییرات مربوط به config و bootstrap این کار زمان می برد، اما هزینه اش بسیار کمتر از رفع خطا در محیط واقعی است. 3) سازگاری پکیج ها را بررسی کنید در بیشتر پروژه های واقعی، چالش اصلی خود Laravel نیست؛ پکیج ها هستند. خیلی از پروژه ها به پکیج هایی وابسته اند که ممکن است: هنوز از Laravel 13 پشتیبانی نکنند نسخه جدید داشته باشند اما نیاز به refactor ایجاد کنند رها شده باشند و نگهداری نشوند با نسخه جدید PHP دچار مشکل شوند برای هر پکیج این سوال ها را بررسی کنید: آخرین commit چه زمانی بوده است؟ آیا در Packagist یا GitHub نسخه سازگار اعلام شده؟ آیا issueهای مرتبط با Laravel 13 گزارش شده؟ آیا جایگزین مطمئن تری برای آن وجود دارد؟ اگر چند پکیج کلیدی ناسازگار باشند، ارتقا ممکن است به تعویق بیفتد یا نیاز به بازنویسی بخشی از پروژه داشته باشید. 4) ابتدا نسخه PHP را تعیین تکلیف کنید اغلب نسخه های جدید Laravel با نسخه های جدیدتر PHP بهتر کار می کنند یا حتی به آنها نیاز دارند. بنابراین قبل از ارتقا باید مشخص کنید: سرور production از چه نسخه ای استفاده می کند؟ آیا extensionهای مورد نیاز نصب هستند؟ آیا کد فعلی پروژه با نسخه جدید PHP سازگار است؟ آیا پکیج های جانبی روی این نسخه بدون مشکل اجرا می شوند؟ گاهی مسئله اصلی Laravel 13 نیست، بلکه مهاجرت واقعی از PHP قدیمی به نسخه جدید است. اگر این بخش را نادیده بگیرید، ممکن است در محیط staging همه چیز خوب باشد اما در production با خطاهای جدی روبرو شوید. قبل از ارتقا، این پیش نیازهای فنی را حتما آماده کنید 5) از پروژه بکاپ کامل بگیرید بکاپ فقط برای دیتابیس نیست. قبل از شروع، این موارد باید قابل بازگشت باشند: سورس کد دیتابیس فایل های آپلودی فایل های env و تنظیمات سرور تنظیمات supervisor، cron و nginx یا apache اگر rollback شفاف نداشته باشید، ارتقا از یک فرایند فنی به یک ریسک تجاری تبدیل می شود. 6) محیط staging واقعی بسازید ارتقا را هرگز مستقیم روی سرور اصلی انجام ندهید. محیط staging باید تا حد ممکن شبیه production باشد: نسخه PHP یکسان همان cache driver همان queue driver تنظیمات مشابه web server داده های نزدیک به واقعیت jobها و eventهای قابل تست اگر محیط staging فقط یک کپی ساده و ناقص باشد، بسیاری از خطاهای واقعی را نشان نخواهد داد. 7) تست خودکار نداشته باشید، ارتقا را شروع نکنید اگر پروژه تست ندارد، ارتقا خطرناک تر از چیزی است که به نظر می رسد. حداقل قبل از مهاجرت، این بخش ها را پوشش دهید: احراز هویت ثبت و ویرایش داده های اصلی پرداخت یا فرایندهای مالی APIهای مهم پنل مدیریت صف ها و jobهای حیاتی حتی چند تست پایه اما درست، از ده ها ساعت دیباگ بعد از deploy باارزش تر است. اشتباه های رایج در ارتقا به Laravel 13 8) ارتقا مستقیم از چند نسخه عقب تر اگر پروژه شما چند نسخه از Laravel عقب است، بهتر است ارتقا را مرحله ای انجام دهید. مثلا مهاجرت از یک نسخه خیلی قدیمی به Laravel 13 در یک مرحله، معمولا باعث انباشت خطا می شود. روش بهتر این است که: ابتدا نسخه فعلی را پایدار کنید warningها و deprecationها را برطرف کنید ارتقا را نسخه به نسخه یا در گام های منطقی جلو ببرید بعد از هر مرحله تست کامل بگیرید 9) نادیده گرفتن کدهای سفارشی و overrideها بسیاری از پروژه ها در طول زمان، کلاس های فریم ورک را extend یا override کرده اند. همین موضوع در زمان ارتقا دردسرساز می شود. بخش های زیر را با دقت بررسی کنید: Service Providerهای سفارشی Macroها Traitهای عمومی Base Controller و Base Model کلاس های helper داخلی Middlewareهای سفارشی Exception Handler ممکن است پروژه بدون خطای syntax بالا بیاید، اما در runtime رفتار نادرستی داشته باشد. 10) اعتماد کامل به composer update بعضی توسعه دهندگان تصور می کنند با اجرای composer update بخش اصلی کار انجام می شود. این فقط شروع کار است. بعد از به روز رسانی وابستگی ها باید این موارد را بررسی کنید: route cache config cache event discovery migrationها queue workerها scheduler mail و notification storage link و file system ارتقا وقتی تمام می شود که رفتار واقعی سیستم تایید شود، نه وقتی composer بدون خطا اجرا شود. چک لیست عملی قبل از ارتقا به Laravel 13 برای اینکه تصمیم گیری ساده تر شود، این چک لیست را قبل از شروع بررسی کنید: چک لیست فنی نسخه فعلی Laravel و PHP مستند شده است تمام پکیج ها و وضعیت سازگاری آنها بررسی شده است Upgrade Guide رسمی مطالعه شده است بکاپ کامل از کد و دیتابیس گرفته شده است محیط staging مشابه production آماده است تست های حیاتی پروژه نوشته یا به روز شده اند فرایند rollback مشخص و تست شده است تغییرات مورد انتظار برای تیم فنی مستند شده است چک لیست اجرایی زمان مناسب برای deploy مشخص شده است ذی نفعان پروژه از زمان ارتقا مطلع هستند plan B در صورت شکست deploy وجود دارد مانیتورینگ و لاگ ها برای بعد از انتشار آماده هستند مسئول بررسی سریع خطاهای production مشخص شده است بهترین روش اجرای ارتقا در پروژه واقعی در پروژه واقعی، این ترتیب معمولا امن تر و منطقی تر است: گام اول: ساخت branch اختصاصی برای ارتقا یک branch جداگانه برای ارتقا ایجاد کنید تا تغییرات از توسعه روزمره پروژه جدا باشد. گام دوم: به روز رسانی وابستگی ها به صورت کنترل شده نسخه Laravel و پکیج ها را مرحله ای به روز کنید و همزمان خطاها را ثبت کنید. گام سوم: رفع breaking changeها هر مورد ناسازگار را بر اساس مستندات رسمی اصلاح کنید. اینجا سرعت مهم نیست؛ دقت مهم تر است. گام چهارم: اجرای تست و تست دستی علاوه بر تست خودکار، سناریوهای واقعی کاربر را هم دستی بررسی کنید. گام پنجم: استقرار آزمایشی در staging رفتار پروژه را در محیط نزدیک به production تحلیل کنید؛ مخصوصا صف ها، فایل ها و APIها. گام ششم: deploy با قابلیت بازگشت ارتقا را در زمانی انجام دهید که اگر مشکل پیش آمد، امکان rollback سریع وجود داشته باشد. آیا الان زمان خوبی برای ارتقا به Laravel 13 است؟ پاسخ این سوال برای همه پروژه ها یکسان نیست. اگر پروژه شما: تست مناسب دارد پکیج های آن فعال و به روز هستند تیم توسعه زمان کافی برای بررسی دارد زیرساخت staging و rollback مشخصی دارد احتمالا ارتقا می تواند یک تصمیم منطقی باشد. اما اگر پروژه: مستندات ضعیف دارد پکیج های قدیمی و رها شده استفاده می کند تست ندارد مستقیم روی production تغییر می دهد بهتر است قبل از ارتقا، ابتدا بلوغ فنی پروژه را بالا ببرید. ارتقا یا بازنگری معماری؟ گاهی سوال اصلی این است در بعضی پروژه ها، مسئله فقط ارتقا نسخه نیست. گاهی ساختار پروژه آن قدر درگیر بدهی فنی شده که ارتقا به تنهایی مشکل را حل نمی کند. اگر در کنار ارتقا به فکر بازنگری معماری، بهبود فرایند توسعه یا استانداردسازی استقرار هستید، مطالعه مطالب فنی و تحلیلی بلاگ طراحان نوین مانند آموزش Vibe Coding در هوش مصنوعی؛ از ایده تا ساخت نرم افزار با زبان طبیعی هم می تواند برای نگاه سیستمی به فرایند توسعه مفید باشد. همچنین اگر پروژه شما بخشی از یک کسب و کار آنلاین بزرگ تر است، پیشنهاد می شود به ارتباط این ارتقا با عملکرد کلی سایت هم توجه کنید. برای مثال، در بسیاری از موارد تغییرات فنی در هسته پروژه باید همزمان با بررسی تجربه کاربری، سرعت و مسیر توسعه وب انجام شود. از این نظر، مقاله چطور بفهمیم کسب و کار ما به سایت جدید نیاز دارد؟ 12 نشانه مهم هم دید بهتری نسبت به تصمیم های فنی در بستر واقعی کسب و کار می دهد. جمع بندی قبل از ارتقا به Laravel 13، مهم ترین کار این نیست که سریع تر به نسخه جدید برسید؛ مهم ترین کار این است که بدون آسیب به پایداری پروژه این مسیر را طی کنید. بررسی سازگاری پکیج ها، نسخه PHP، تست ها، staging، بکاپ و سناریوی بازگشت، همگی از خود فرایند ارتقا مهم تر هستند. اگر این مسیر را مرحله ای، مستند و واقع بینانه پیش ببرید، ارتقا می تواند باعث بهبود نگهداری پروژه، افزایش امنیت و هماهنگی بهتر با ابزارهای جدید توسعه شود. اما اگر بدون آماده سازی سراغ آن بروید، حتی یک پروژه ظاهرا پایدار هم ممکن است درگیر خطاهای زمان بر و پرهزینه شود. برای اطلاعات دقیق و رسمی درباره روند مهاجرت نسخه های لاراول، حتما مستندات رسمی Laravel و بخش release notes فریم ورک Laravel را هم بررسی کنید. اگر برای بررسی فنی، بازبینی ساختار پروژه، بهینه سازی فرایند توسعه یا اجرای ارتقا در یک پروژه واقعی به همراه تیم متخصص نیاز دارید، با طراحان نوین در ارتباط باشید.</p>
<p>نوشته <a href="https://tarahanenovin.ir/blog/%d9%82%d8%a8%d9%84-%d8%a7%d8%b2-%d8%a7%d8%b1%d8%aa%d9%82%d8%a7-%d8%a8%d9%87-laravel-13-%d8%a7%db%8c%d9%86-%d9%86%da%a9%d8%a7%d8%aa-%d8%b1%d8%a7-%d8%a8%d8%af%d8%a7%d9%86%db%8c%d8%af/">قبل از ارتقا به Laravel 13 این نکات را بدانید</a> اولین بار در <a href="https://tarahanenovin.ir/blog">نوین هاب</a>. پدیدار شد.</p>
]]></description>
										<content:encoded><![CDATA[<p dir="rtl" lang="fa">اگر در حال برنامه ریزی برای ارتقا به Laravel 13 هستید، بهتر است قبل از هر اقدامی فقط به تغییر شماره نسخه نگاه نکنید. ارتقا فریم ورک در پروژه های واقعی، مخصوصا پروژه هایی که در حال سرویس دهی هستند، می تواند روی پکیج ها، ساختار کد، فرایند استقرار، تست ها و حتی عملکرد تیم توسعه اثر مستقیم بگذارد. به همین دلیل، قبل از ارتقا به Laravel 13 باید تصویر روشنی از وضعیت فعلی پروژه، وابستگی ها و ریسک های اجرایی داشته باشید.</p>
<p dir="rtl" lang="fa">این مقاله با نگاه کاملا عملی نوشته شده است؛ یعنی اگر یک پروژه واقعی دارید و می خواهید تصمیم بگیرید که آیا الان زمان مناسبی برای ارتقا هست یا نه، این مطلب می تواند به شما کمک کند.</p>
<h2 dir="rtl" lang="fa">چرا ارتقا به Laravel 13 فقط یک به روز رسانی ساده نیست؟</h2>
<p dir="rtl" lang="fa">در پروژه های آزمایشی، ارتقا نسخه معمولا با چند تغییر محدود در <code>composer.json</code> و رفع چند خطا تمام می شود. اما در پروژه های واقعی شرایط متفاوت است. در عمل، شما فقط خود Laravel را ارتقا نمی دهید، بلکه زنجیره ای از بخش های زیر هم درگیر می شوند:</p>
<ul dir="rtl" lang="fa">
<li>نسخه PHP سرور</li>
<li>پکیج های Composer</li>
<li>کدهای سفارشی شده پروژه</li>
<li>Middlewareها و Service Providerها</li>
<li>تست های خودکار</li>
<li>Docker یا تنظیمات محیط استقرار</li>
<li>CI/CD</li>
<li>صف ها، کرون جاب ها و سرویس های جانبی</li>
</ul>
<p dir="rtl" lang="fa">به همین دلیل، تصمیم برای ارتقا باید فنی، مرحله ای و همراه با ارزیابی ریسک باشد؛ نه صرفا به دلیل جدید بودن نسخه.</p>
<h2 dir="rtl" lang="fa">قبل از هر چیز، مطمئن شوید Laravel 13 واقعا برای پروژه شما لازم است</h2>
<p dir="rtl" lang="fa">یکی از اشتباه های رایج این است که فقط چون نسخه جدید منتشر شده، تیم توسعه بلافاصله به فکر مهاجرت می افتد. در حالی که در بسیاری از پروژه ها، ارتقا زمانی منطقی است که حداقل یکی از شرایط زیر وجود داشته باشد:</p>
<ul dir="rtl" lang="fa">
<li>پروژه به قابلیت های جدید نسخه جدید نیاز دارد</li>
<li>نسخه فعلی شما به پایان پشتیبانی نزدیک شده است</li>
<li>بعضی پکیج های مهم فقط با نسخه های جدید سازگارند</li>
<li>تیم می خواهد بدهی فنی پروژه را کاهش دهد</li>
<li>زیرساخت و استانداردهای توسعه در حال بازبینی هستند</li>
</ul>
<p dir="rtl" lang="fa">اگر هیچ کدام از این موارد وجود ندارد و پروژه پایدار است، شاید بهتر باشد ابتدا روی تست، مستندسازی و بهینه سازی کد تمرکز کنید. در همین زمینه، اگر به موضوع زیرساخت و استقرار استاندارد علاقه دارید، مطالعه مقاله <a href="https://tarahanenovin.ir/blog/%d8%a2%d9%85%d9%88%d8%b2%d8%b4-docker-%d8%a7%d8%b2-%d8%b5%d9%81%d8%b1-%d8%aa%d8%a7-%d8%a7%d8%ac%d8%b1%d8%a7%db%8c-%d9%be%d8%b1%d9%88%da%98%d9%87-%d9%88%d8%a7%d9%82%d8%b9%db%8c-%d8%a8/" target="_blank" rel="nofollow noopener noreferrer">آموزش Docker از صفر تا اجرای پروژه واقعی با داکر</a> هم می تواند برای آماده سازی محیط ارتقا مفید باشد.</p>
<h2 dir="rtl" lang="fa">مهم ترین بررسی ها قبل از ارتقا به Laravel 13</h2>
<h3 dir="rtl" lang="fa">1) وضعیت نسخه فعلی پروژه را دقیق ثبت کنید</h3>
<p dir="rtl" lang="fa">قبل از هر کاری، باید بدانید الان دقیقا در چه نقطه ای هستید. فقط دانستن اینکه پروژه مثلا Laravel 10 یا 11 است کافی نیست. موارد زیر را مستند کنید:</p>
<ul dir="rtl" lang="fa">
<li>نسخه دقیق Laravel</li>
<li>نسخه PHP در لوکال، staging و production</li>
<li>لیست تمام پکیج های Composer</li>
<li>پکیج های اختصاصی یا fork شده</li>
<li>ابزارهای فرانت اند مثل Vite، Node.js و NPM</li>
<li>ساختار تست ها</li>
<li>تنظیمات queue، cache، session و mail</li>
<li>روش deploy فعلی</li>
</ul>
<p dir="rtl" lang="fa">این مرحله به ظاهر ساده است، اما در عمل باعث می شود بعدا با خطاهای غیرمنتظره غافلگیر نشوید.</p>
<h3 dir="rtl" lang="fa">2) Release Note و Upgrade Guide را خط به خط بخوانید</h3>
<p dir="rtl" lang="fa">بزرگ ترین اشتباه در ارتقا این است که توسعه دهنده مستقیما سراغ تغییر نسخه برود و بعد شروع به رفع خطا کند. روش حرفه ای این است که ابتدا مستندات رسمی Laravel برای نسخه جدید را کامل بررسی کنید.</p>
<p dir="rtl" lang="fa">هنگام مطالعه Upgrade Guide به این موارد توجه ویژه داشته باشید:</p>
<ul dir="rtl" lang="fa">
<li>Breaking Changeها</li>
<li>تغییرات مربوط به routing</li>
<li>تغییرات Eloquent</li>
<li>تغییرات validation</li>
<li>تغییرات queue و jobها</li>
<li>حذف شدن helperها یا APIهای قدیمی</li>
<li>تغییرات مربوط به config و bootstrap</li>
</ul>
<p dir="rtl" lang="fa">این کار زمان می برد، اما هزینه اش بسیار کمتر از رفع خطا در محیط واقعی است.</p>
<h3 dir="rtl" lang="fa">3) سازگاری پکیج ها را بررسی کنید</h3>
<p dir="rtl" lang="fa">در بیشتر پروژه های واقعی، چالش اصلی خود Laravel نیست؛ پکیج ها هستند. خیلی از پروژه ها به پکیج هایی وابسته اند که ممکن است:</p>
<ul dir="rtl" lang="fa">
<li>هنوز از Laravel 13 پشتیبانی نکنند</li>
<li>نسخه جدید داشته باشند اما نیاز به refactor ایجاد کنند</li>
<li>رها شده باشند و نگهداری نشوند</li>
<li>با نسخه جدید PHP دچار مشکل شوند</li>
</ul>
<p dir="rtl" lang="fa">برای هر پکیج این سوال ها را بررسی کنید:</p>
<ul dir="rtl" lang="fa">
<li>آخرین commit چه زمانی بوده است؟</li>
<li>آیا در Packagist یا GitHub نسخه سازگار اعلام شده؟</li>
<li>آیا issueهای مرتبط با Laravel 13 گزارش شده؟</li>
<li>آیا جایگزین مطمئن تری برای آن وجود دارد؟</li>
</ul>
<p dir="rtl" lang="fa">اگر چند پکیج کلیدی ناسازگار باشند، ارتقا ممکن است به تعویق بیفتد یا نیاز به بازنویسی بخشی از پروژه داشته باشید.</p>
<h3 dir="rtl" lang="fa">4) ابتدا نسخه PHP را تعیین تکلیف کنید</h3>
<p dir="rtl" lang="fa">اغلب نسخه های جدید Laravel با نسخه های جدیدتر PHP بهتر کار می کنند یا حتی به آنها نیاز دارند. بنابراین قبل از ارتقا باید مشخص کنید:</p>
<ul dir="rtl" lang="fa">
<li>سرور production از چه نسخه ای استفاده می کند؟</li>
<li>آیا extensionهای مورد نیاز نصب هستند؟</li>
<li>آیا کد فعلی پروژه با نسخه جدید PHP سازگار است؟</li>
<li>آیا پکیج های جانبی روی این نسخه بدون مشکل اجرا می شوند؟</li>
</ul>
<p dir="rtl" lang="fa">گاهی مسئله اصلی Laravel 13 نیست، بلکه مهاجرت واقعی از PHP قدیمی به نسخه جدید است. اگر این بخش را نادیده بگیرید، ممکن است در محیط staging همه چیز خوب باشد اما در production با خطاهای جدی روبرو شوید.</p>
<h2 dir="rtl" lang="fa">قبل از ارتقا، این پیش نیازهای فنی را حتما آماده کنید</h2>
<h3 dir="rtl" lang="fa">5) از پروژه بکاپ کامل بگیرید</h3>
<p dir="rtl" lang="fa">بکاپ فقط برای دیتابیس نیست. قبل از شروع، این موارد باید قابل بازگشت باشند:</p>
<ul dir="rtl" lang="fa">
<li>سورس کد</li>
<li>دیتابیس</li>
<li>فایل های آپلودی</li>
<li>فایل های env و تنظیمات سرور</li>
<li>تنظیمات supervisor، cron و nginx یا apache</li>
</ul>
<p dir="rtl" lang="fa">اگر rollback شفاف نداشته باشید، ارتقا از یک فرایند فنی به یک ریسک تجاری تبدیل می شود.</p>
<h3 dir="rtl" lang="fa">6) محیط staging واقعی بسازید</h3>
<p dir="rtl" lang="fa">ارتقا را هرگز مستقیم روی سرور اصلی انجام ندهید. محیط staging باید تا حد ممکن شبیه production باشد:</p>
<ul dir="rtl" lang="fa">
<li>نسخه PHP یکسان</li>
<li>همان cache driver</li>
<li>همان queue driver</li>
<li>تنظیمات مشابه web server</li>
<li>داده های نزدیک به واقعیت</li>
<li>jobها و eventهای قابل تست</li>
</ul>
<p dir="rtl" lang="fa">اگر محیط staging فقط یک کپی ساده و ناقص باشد، بسیاری از خطاهای واقعی را نشان نخواهد داد.</p>
<h3 dir="rtl" lang="fa">7) تست خودکار نداشته باشید، ارتقا را شروع نکنید</h3>
<p dir="rtl" lang="fa">اگر پروژه تست ندارد، ارتقا خطرناک تر از چیزی است که به نظر می رسد. حداقل قبل از مهاجرت، این بخش ها را پوشش دهید:</p>
<ul dir="rtl" lang="fa">
<li>احراز هویت</li>
<li>ثبت و ویرایش داده های اصلی</li>
<li>پرداخت یا فرایندهای مالی</li>
<li>APIهای مهم</li>
<li>پنل مدیریت</li>
<li>صف ها و jobهای حیاتی</li>
</ul>
<p dir="rtl" lang="fa">حتی چند تست پایه اما درست، از ده ها ساعت دیباگ بعد از deploy باارزش تر است.</p>
<h2 dir="rtl" lang="fa">اشتباه های رایج در ارتقا به Laravel 13</h2>
<h3 dir="rtl" lang="fa">8) ارتقا مستقیم از چند نسخه عقب تر</h3>
<p dir="rtl" lang="fa">اگر پروژه شما چند نسخه از Laravel عقب است، بهتر است ارتقا را مرحله ای انجام دهید. مثلا مهاجرت از یک نسخه خیلی قدیمی به Laravel 13 در یک مرحله، معمولا باعث انباشت خطا می شود.</p>
<p dir="rtl" lang="fa">روش بهتر این است که:</p>
<ul dir="rtl" lang="fa">
<li>ابتدا نسخه فعلی را پایدار کنید</li>
<li>warningها و deprecationها را برطرف کنید</li>
<li>ارتقا را نسخه به نسخه یا در گام های منطقی جلو ببرید</li>
<li>بعد از هر مرحله تست کامل بگیرید</li>
</ul>
<h3 dir="rtl" lang="fa">9) نادیده گرفتن کدهای سفارشی و overrideها</h3>
<p dir="rtl" lang="fa">بسیاری از پروژه ها در طول زمان، کلاس های فریم ورک را extend یا override کرده اند. همین موضوع در زمان ارتقا دردسرساز می شود. بخش های زیر را با دقت بررسی کنید:</p>
<ul dir="rtl" lang="fa">
<li>Service Providerهای سفارشی</li>
<li>Macroها</li>
<li>Traitهای عمومی</li>
<li>Base Controller و Base Model</li>
<li>کلاس های helper داخلی</li>
<li>Middlewareهای سفارشی</li>
<li>Exception Handler</li>
</ul>
<p dir="rtl" lang="fa">ممکن است پروژه بدون خطای syntax بالا بیاید، اما در runtime رفتار نادرستی داشته باشد.</p>
<h3 dir="rtl" lang="fa">10) اعتماد کامل به composer update</h3>
<p dir="rtl" lang="fa">بعضی توسعه دهندگان تصور می کنند با اجرای <code>composer update</code> بخش اصلی کار انجام می شود. این فقط شروع کار است. بعد از به روز رسانی وابستگی ها باید این موارد را بررسی کنید:</p>
<ul dir="ltr" lang="en">
<li>route cache</li>
<li>config cache</li>
<li>event discovery</li>
<li>migrationها</li>
<li>queue workerها</li>
<li>scheduler</li>
<li>mail و notification</li>
<li>storage link و file system</li>
</ul>
<p dir="rtl" lang="fa">ارتقا وقتی تمام می شود که رفتار واقعی سیستم تایید شود، نه وقتی composer بدون خطا اجرا شود.</p>
<h2 dir="rtl" lang="fa">چک لیست عملی قبل از ارتقا به Laravel 13</h2>
<p dir="rtl" lang="fa">برای اینکه تصمیم گیری ساده تر شود، این چک لیست را قبل از شروع بررسی کنید:</p>
<h3 dir="rtl" lang="fa">چک لیست فنی</h3>
<ul dir="rtl" lang="fa">
<li>نسخه فعلی Laravel و PHP مستند شده است</li>
<li>تمام پکیج ها و وضعیت سازگاری آنها بررسی شده است</li>
<li>Upgrade Guide رسمی مطالعه شده است</li>
<li>بکاپ کامل از کد و دیتابیس گرفته شده است</li>
<li>محیط staging مشابه production آماده است</li>
<li>تست های حیاتی پروژه نوشته یا به روز شده اند</li>
<li>فرایند rollback مشخص و تست شده است</li>
<li>تغییرات مورد انتظار برای تیم فنی مستند شده است</li>
</ul>
<h3 dir="rtl" lang="fa">چک لیست اجرایی</h3>
<ul dir="rtl" lang="fa">
<li>زمان مناسب برای deploy مشخص شده است</li>
<li>ذی نفعان پروژه از زمان ارتقا مطلع هستند</li>
<li>plan B در صورت شکست deploy وجود دارد</li>
<li>مانیتورینگ و لاگ ها برای بعد از انتشار آماده هستند</li>
<li>مسئول بررسی سریع خطاهای production مشخص شده است</li>
</ul>
<h2 dir="rtl" lang="fa">بهترین روش اجرای ارتقا در پروژه واقعی</h2>
<p dir="rtl" lang="fa">در پروژه واقعی، این ترتیب معمولا امن تر و منطقی تر است:</p>
<h3 dir="rtl" lang="fa">گام اول: ساخت branch اختصاصی برای ارتقا</h3>
<p dir="rtl" lang="fa">یک branch جداگانه برای ارتقا ایجاد کنید تا تغییرات از توسعه روزمره پروژه جدا باشد.</p>
<h3 dir="rtl" lang="fa">گام دوم: به روز رسانی وابستگی ها به صورت کنترل شده</h3>
<p dir="rtl" lang="fa">نسخه Laravel و پکیج ها را مرحله ای به روز کنید و همزمان خطاها را ثبت کنید.</p>
<h3 dir="rtl" lang="fa">گام سوم: رفع breaking changeها</h3>
<p dir="rtl" lang="fa">هر مورد ناسازگار را بر اساس مستندات رسمی اصلاح کنید. اینجا سرعت مهم نیست؛ دقت مهم تر است.</p>
<h3 dir="rtl" lang="fa">گام چهارم: اجرای تست و تست دستی</h3>
<p dir="rtl" lang="fa">علاوه بر تست خودکار، سناریوهای واقعی کاربر را هم دستی بررسی کنید.</p>
<h3 dir="rtl" lang="fa">گام پنجم: استقرار آزمایشی در staging</h3>
<p dir="rtl" lang="fa">رفتار پروژه را در محیط نزدیک به production تحلیل کنید؛ مخصوصا صف ها، فایل ها و APIها.</p>
<h3 dir="rtl" lang="fa">گام ششم: deploy با قابلیت بازگشت</h3>
<p dir="rtl" lang="fa">ارتقا را در زمانی انجام دهید که اگر مشکل پیش آمد، امکان rollback سریع وجود داشته باشد.</p>
<h2 dir="rtl" lang="fa">آیا الان زمان خوبی برای ارتقا به Laravel 13 است؟</h2>
<p dir="rtl" lang="fa">پاسخ این سوال برای همه پروژه ها یکسان نیست. اگر پروژه شما:</p>
<ul dir="rtl" lang="fa">
<li>تست مناسب دارد</li>
<li>پکیج های آن فعال و به روز هستند</li>
<li>تیم توسعه زمان کافی برای بررسی دارد</li>
<li>زیرساخت staging و rollback مشخصی دارد</li>
</ul>
<p dir="rtl" lang="fa">احتمالا ارتقا می تواند یک تصمیم منطقی باشد.</p>
<p dir="rtl" lang="fa">اما اگر پروژه:</p>
<ul dir="rtl" lang="fa">
<li>مستندات ضعیف دارد</li>
<li>پکیج های قدیمی و رها شده استفاده می کند</li>
<li>تست ندارد</li>
<li>مستقیم روی production تغییر می دهد</li>
</ul>
<p dir="rtl" lang="fa">بهتر است قبل از ارتقا، ابتدا بلوغ فنی پروژه را بالا ببرید.</p>
<h2 dir="rtl" lang="fa">ارتقا یا بازنگری معماری؟ گاهی سوال اصلی این است</h2>
<p dir="rtl" lang="fa">در بعضی پروژه ها، مسئله فقط ارتقا نسخه نیست. گاهی ساختار پروژه آن قدر درگیر بدهی فنی شده که ارتقا به تنهایی مشکل را حل نمی کند. اگر در کنار ارتقا به فکر بازنگری معماری، بهبود فرایند توسعه یا استانداردسازی استقرار هستید، مطالعه مطالب فنی و تحلیلی بلاگ طراحان نوین مانند <a href="https://tarahanenovin.ir/blog/%d8%a2%d9%85%d9%88%d8%b2%d8%b4-vibe-coding-%d8%af%d8%b1-%d9%87%d9%88%d8%b4-%d9%85%d8%b5%d9%86%d9%88%d8%b9%db%8c%d8%9b-%d8%a7%d8%b2-%d8%a7%db%8c%d8%af%d9%87-%d8%aa%d8%a7-%d8%b3/" target="_blank" rel="nofollow noopener noreferrer">آموزش Vibe Coding در هوش مصنوعی؛ از ایده تا ساخت نرم افزار با زبان طبیعی</a> هم می تواند برای نگاه سیستمی به فرایند توسعه مفید باشد.</p>
<p dir="rtl" lang="fa">همچنین اگر پروژه شما بخشی از یک کسب و کار آنلاین بزرگ تر است، پیشنهاد می شود به ارتباط این ارتقا با عملکرد کلی سایت هم توجه کنید. برای مثال، در بسیاری از موارد تغییرات فنی در هسته پروژه باید همزمان با بررسی تجربه کاربری، سرعت و مسیر توسعه وب انجام شود. از این نظر، مقاله <a href="https://tarahanenovin.ir/blog/%da%86%d8%b7%d9%88%d8%b1-%d8%a8%d9%81%d9%87%d9%85%db%8c%d9%85-%da%a9%d8%b3%d8%a8-%d9%88-%da%a9%d8%a7%d8%b1-%d9%85%d8%a7-%d8%a8%d9%87-%d8%b3%d8%a7%db%8c%d8%aa-%d8%ac%d8%af%db%8c%d8%af-%d9%86%db%8c/" target="_blank" rel="nofollow noopener noreferrer">چطور بفهمیم کسب و کار ما به سایت جدید نیاز دارد؟ 12 نشانه مهم</a> هم دید بهتری نسبت به تصمیم های فنی در بستر واقعی کسب و کار می دهد.</p>
<h2 dir="rtl" lang="fa">جمع بندی</h2>
<p dir="rtl" lang="fa">قبل از ارتقا به Laravel 13، مهم ترین کار این نیست که سریع تر به نسخه جدید برسید؛ مهم ترین کار این است که بدون آسیب به پایداری پروژه این مسیر را طی کنید. بررسی سازگاری پکیج ها، نسخه PHP، تست ها، staging، بکاپ و سناریوی بازگشت، همگی از خود فرایند ارتقا مهم تر هستند.</p>
<p dir="rtl" lang="fa">اگر این مسیر را مرحله ای، مستند و واقع بینانه پیش ببرید، ارتقا می تواند باعث بهبود نگهداری پروژه، افزایش امنیت و هماهنگی بهتر با ابزارهای جدید توسعه شود. اما اگر بدون آماده سازی سراغ آن بروید، حتی یک پروژه ظاهرا پایدار هم ممکن است درگیر خطاهای زمان بر و پرهزینه شود.</p>
<p dir="rtl" lang="fa">برای اطلاعات دقیق و رسمی درباره روند مهاجرت نسخه های لاراول، حتما <a href="https://laravel.com/docs" target="_blank" rel="nofollow noopener noreferrer">مستندات رسمی Laravel</a> و <a href="https://laravel.com/docs/releases" target="_blank" rel="nofollow noopener noreferrer">بخش release notes فریم ورک Laravel</a> را هم بررسی کنید.</p>
<p dir="rtl" lang="fa">اگر برای بررسی فنی، بازبینی ساختار پروژه، بهینه سازی فرایند توسعه یا اجرای ارتقا در یک پروژه واقعی به همراه تیم متخصص نیاز دارید، <a href="https://tarahanenovin.ir/site/contact" target="_blank" rel="nofollow noopener noreferrer">با طراحان نوین در ارتباط باشید</a>.</p>
<p>نوشته <a href="https://tarahanenovin.ir/blog/%d9%82%d8%a8%d9%84-%d8%a7%d8%b2-%d8%a7%d8%b1%d8%aa%d9%82%d8%a7-%d8%a8%d9%87-laravel-13-%d8%a7%db%8c%d9%86-%d9%86%da%a9%d8%a7%d8%aa-%d8%b1%d8%a7-%d8%a8%d8%af%d8%a7%d9%86%db%8c%d8%af/">قبل از ارتقا به Laravel 13 این نکات را بدانید</a> اولین بار در <a href="https://tarahanenovin.ir/blog">نوین هاب</a>. پدیدار شد.</p>
]]></content:encoded>
					
					<wfw:commentRss>https://tarahanenovin.ir/blog/%d9%82%d8%a8%d9%84-%d8%a7%d8%b2-%d8%a7%d8%b1%d8%aa%d9%82%d8%a7-%d8%a8%d9%87-laravel-13-%d8%a7%db%8c%d9%86-%d9%86%da%a9%d8%a7%d8%aa-%d8%b1%d8%a7-%d8%a8%d8%af%d8%a7%d9%86%db%8c%d8%af/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
			</item>
	</channel>
</rss>
