آرگومان‌ها و مقادیر بازگشتی در توابع پی اچ پی

توابع در زبان PHP مانند ماشین‌های پردازشگری هستند که کدهای شما را ساختاریافته و ماژولار می‌کنند. برای اینکه این ماشین‌ها به درستی کار کنند، نیازمند دریافت مواد اولیه (ورودی) و تحویل محصول نهایی (خروجی) هستند. در دنیای برنامه‌نویسی، به این ورودی‌ها آرگومان (Arguments) و به خروجی‌ها مقادیر بازگشتی (Return Values) گفته می‌شود.

در این مقاله از آموزش‌های تخصصی پی اچ پی ساز، به بررسی عمیق مکانیزم انتقال داده‌ها در توابع می‌پردازیم و با ویژگی‌های مدرن نسخه‌های جدید PHP (مانند PHP 8 به بالا) در مدیریت آرگومان‌ها و خروجی‌ها آشنا می‌شویم تا بتوانید کدهایی در سطح فریم‌ورک‌های قدرتمندی نظیر لاراول بنویسید.

آرگومان‌ها در PHP: دروازه ورود داده‌ها

آرگومان‌ها متغیرهایی هستند که هنگام فراخوانی یک تابع، به داخل آن پاس داده می‌شوند. در تعریف تابع به این متغیرها پارامتر (Parameter) می‌گویند. شما می‌توانید هر تعداد آرگومان که نیاز دارید را با استفاده از کاما (,) از یکدیگر جدا کنید.

۱. مقداردهی پیش‌فرض (Default Arguments)

گاهی اوقات می‌خواهیم اگر کاربر مقداری برای یک پارامتر ارسال نکرد، تابع از یک مقدار پیش‌فرض استفاده کند و دچار خطای (Fatal Error) نشود. این کار به سادگی با علامت مساوی = در زمان تعریف تابع انجام می‌شود:

<?php
function setDiscount($price, $discount = 10) {
    $finalPrice = $price - (($price * $discount) / 100);
    return $finalPrice;
}

echo setDiscount(1000); // خروجی: 900 (استفاده از تخفیف پیش‌فرض 10 درصدی)
echo setDiscount(1000, 20); // خروجی: 800 (تخفیف 20 درصدی جایگزین شد)
?>

نکته مهم: همیشه پارامترهای دارای مقدار پیش‌فرض را در انتهای لیست پارامترها قرار دهید.

۲. ارسال با ارجاع (Pass by Reference)

به طور پیش‌فرض، PHP یک کپی از مقدار آرگومان را به تابع ارسال می‌کند (Pass by Value). بنابراین تغییرات داخل تابع، روی متغیر اصلی تاثیری ندارد. اما اگر بخواهید متغیر اصلی مستقیماً تغییر کند، باید از علامت & (آمپرسند) قبل از نام پارامتر استفاده کنید:

<?php
function addText(&$string) {
    $string .= " و آموزش‌های پی اچ پی ساز";
}

$message = "یادگیری برنامه‌نویسی";
addText($message);
echo $message; // خروجی: یادگیری برنامه‌نویسی و آموزش‌های پی اچ پی ساز
?>

۳. آرگومان‌های نام‌دار (Named Arguments – ویژگی PHP 8)

در نسخه‌های مدرن PHP (از نسخه 8.0 به بعد)، ویژگی فوق‌العاده‌ای به نام آرگومان‌های نام‌دار اضافه شد. با این قابلیت، دیگر نیازی نیست ترتیب دقیق پارامترها را هنگام فراخوانی حفظ کنید؛ بلکه می‌توانید نام پارامتر را مشخص کرده و مقدار را به آن پاس دهید. این ویژگی خوانایی کدهای پیچیده را به شدت بالا می‌برد:

<?php
function createUser($username, $email, $role = 'subscriber', $status = 'active') {
    // عملیات ثبت کاربر
}

// استفاده از آرگومان‌های نام‌دار بدون رعایت ترتیب و نادیده گرفتن مقادیر پیش‌فرض میانی
createUser(status: 'pending', email: 'test@test.com', username: 'Ali_Reza');
?>

مقادیر بازگشتی (Return Values): خروجی پردازش‌ها

هدف نهایی بسیاری از توابع، انجام یک پردازش و برگرداندن نتیجه آن برای استفاده در بخش‌های دیگر برنامه است. این کار با استفاده از کلمه کلیدی return انجام می‌شود.

۱. استفاده از return

دستور return نه تنها مقدار را برمی‌گرداند، بلکه اجرای تابع را در همان نقطه متوقف می‌کند.

<?php
function checkEligibility($age) {
    if ($age < 18) {
        return false; // اجرای تابع اینجا متوقف می‌شود
    }
    return true;
}
?>

۲. بازگرداندن چندین مقدار همزمان

توابع در PHP تنها می‌توانند یک مقدار را برگردانند. اما اگر بخواهیم نتیجه چند پردازش را دریافت کنیم، راهکار چیست؟ بهترین روش، استفاده از آرایه‌ها است:

<?php
function getUserDetails() {
    $user = [
        'name' => 'محمد',
        'email' => 'mohammad@domain.com',
        'level' => 'admin'
    ];
    return $user;
}

$details = getUserDetails();
echo $details['name']; // خروجی: محمد
?>

۳. تعیین نوع داده خروجی (Return Type Declarations)

برای نوشتن کدهای استاندارد و ایمن (به ویژه در پروژه‌های بزرگ)، بهتر است نوع داده‌ای که تابع برمی‌گرداند را دقیقاً مشخص کنید. اگر تابع چیزی برنمی‌گرداند، از نوع void استفاده می‌کنیم:

<?php
// این تابع حتما باید یک عدد صحیح برگرداند
function sum(int $a, int $b): int {
    return $a + $b;
}

// در نسخه‌های جدید می‌توان از Union Types استفاده کرد (یا صحیح یا اعشاری)
function calculateTotal(float $amount, float $tax): int|float {
    return $amount + $tax;
}
?>

نتیجه‌گیری

تسلط بر نحوه مدیریت آرگومان‌ها و مقادیر بازگشتی، مرز بین یک کدنویس مبتدی و یک توسعه‌دهنده حرفه‌ای را مشخص می‌کند. استفاده هوشمندانه از قابلیت‌های جدید مانند Type Hinting و آرگومان‌های نام‌دار، به شما کمک می‌کند تا توابعی بنویسید که نه تنها باگ کمتری دارند، بلکه پایه و اساس معماری نرم‌افزارهای پیچیده و اختصاصی شما را به محکم‌ترین شکل ممکن بنا می‌کنند. با تمرین این مفاهیم در سایت پی اچ پی ساز، مهارت‌های بک‌اند خود را به سطح بالاتری ارتقا دهید.