Tại sao nên sử dụng hàm sprintf trong PHP?

Tôi đang cố gắng tìm hiểu thêm về hàm PHP sprintf () nhưng php.net không giúp tôi nhiều vì tôi vẫn còn bối rối, tại sao bạn lại muốn sử dụng nó?

Hãy xem ví dụ của tôi dưới đây.

Tại sao nên sử dụng cái này:

$output = sprintf("Here is the result: %s for this date %s", $result, $date);

Khi điều này làm tương tự và dễ dàng hơn để viết IMO:

$output = 'Here is the result: ' .$result. ' for this date ' .$date;

Am i thiếu cái gì ở đây?

sprintf có tất cả các khả năng định dạng của printf gốc, điều đó có nghĩa là bạn có thể làm được nhiều hơn là chỉ chèn các giá trị biến trong chuỗi.

Ví dụ: chỉ định định dạng số (hex, thập phân, bát phân), số thập phân, phần đệm và hơn thế nữa. Google cho printf và bạn sẽ tìm thấy rất nhiều ví dụ. Các bài viết trên wikipedia printf nên giúp bạn bắt đầu.

Có nhiều trường hợp sử dụng cho sprintf nhưng một cách mà tôi sử dụng chúng là lưu trữ một chuỗi như thế này: 'Xin chào, Tên tôi là% s' trong cơ sở dữ liệu hoặc là một hằng số trong lớp PHP. Theo cách đó khi tôi muốn sử dụng chuỗi đó, tôi có thể chỉ cần làm điều này:

$name = 'Josh';
// $stringFromDB = 'Hello, My Name is %s';
$greeting = sprintf($stringFromDB, $name);
// $greetting = 'Hello, My Name is Josh'

Về cơ bản nó cho phép một số phân tách trong mã. Nếu tôi sử dụng 'Xin chào, Tên tôi là% s' ở nhiều nơi trong mã của tôi, tôi có thể đổi nó thành '% s là tên của tôi' ở một nơi và nó cập nhật ở mọi nơi khác một cách tự động, mà không cần phải đi đến từng trường hợp và di chuyển xung quanh ghép nối.

Một cách sử dụng khác sprintflà trong các ứng dụng được bản địa hóa làm đối số chosprintf không phải theo thứ tự chúng xuất hiện trong chuỗi định dạng.

Thí dụ:

$color = 'blue';
$item = 'pen';

sprintf('I have a %s %s', $color, $item);

Nhưng một ngôn ngữ như tiếng Pháp ra lệnh cho các từ khác nhau:

$color = 'bleu';
$item = 'stylo';

sprintf('J\'ai un %2$s %1$s', $color, $item);

(Vâng, tiếng Pháp của tôi thật tệ: Tôi đã học tiếng Đức ở trường!)

Trong thực tế, bạn sẽ sử dụng gettext để lưu trữ các chuỗi được bản địa hóa nhưng bạn có ý tưởng.

Nó dễ dịch hơn.

echo _('Here is the result: ') . $result . _(' for this date ') . $date;

Các chuỗi dịch (gettext) hiện là:

• Đây là kết quả:
• cho ngày này

Khi được dịch sang một số ngôn ngữ khác, điều đó có thể là không thể hoặc dẫn đến những câu rất kỳ lạ.

Bây giờ nếu bạn có

echo sprintf(_("Here is the result: %s for this date %s"), $result, $date);

Các chuỗi dịch (gettext) hiện là:

• Đây là kết quả:% s cho ngày này% s

Điều này có ý nghĩa hơn nhiều và nó linh hoạt hơn nhiều để dịch sang các ngôn ngữ khác

Lý do tốt nhất mà tôi đã tìm thấy là nó cho phép bạn đặt tất cả các chuỗi ngôn ngữ trong tệp ngôn ngữ của mình là mọi người có thể dịch và đặt hàng chúng khi cần - tuy nhiên bạn vẫn biết rằng dù chuỗi đó ở định dạng nào - bạn muốn hiển thị tên người dùng.

Ví dụ: trang web của bạn sẽ nói "Chào mừng trở lại [[Người dùng]]" ở đầu trang. Là lập trình viên mà bạn không biết hoặc không quan tâm đến việc các anh chàng UI sẽ viết như thế nào - bạn chỉ cần biết rằng tên người dùng sẽ được hiển thị ở đâu đó trong tin nhắn.

Vì vậy, bạn có thể nhúng tin nhắn vào mã của mình mà không phải lo lắng về thông điệp đó thực sự là gì.

Tệp Lang (EN_US):

...
$lang['welcome_message'] = 'Welcome back %s';
...

Sau đó, bạn có thể hỗ trợ bất kỳ loại tin nhắn bằng bất kỳ ngôn ngữ nào bằng cách sử dụng mã này trong mã php thực tế của bạn.

sprintf($lang['welcome_message'], $user->name())

Tại sao bạn muốn sử dụng nó?

Nó chứng tỏ rất hữu ích khi sử dụng nguồn (bên ngoài) cho các chuỗi ngôn ngữ. Nếu bạn cần một số lượng biến cố định trong một chuỗi đa ngôn ngữ nhất định, bạn chỉ cần biết thứ tự chính xác:

en.txt

not_found    = "%s could not be found."
bad_argument = "Bad arguments for function %s."
bad_arg_no   = "Bad argument %d for function %s."

hu.txt

not_found    = "A keresett eljárás (%s) nem található."
bad_argument = "Érvénytelen paraméterek a(z) %s eljárás hívásakor."
bad_arg_no   = "Érvénytelen %d. paraméter a(z) %s eljárás hívásakor."

Các biến được chèn thậm chí không phải ở đầu hoặc cuối trên nhiều ngôn ngữ, chỉ có vấn đề đặt hàng của chúng.

Tất nhiên, bạn có thể viết chức năng của riêng mình để thực hiện thay thế này, chắc chắn ngay cả với một số tăng hiệu suất nhỏ, nhưng nó nhanh hơn nhiều (Language chỉ cần bạn có một lớp để đọc các chuỗi ngôn ngữ) :

/**
 * throws exception with message($name = "ExampleMethod"):
 *  - using en.txt: ExampleMethod could not be found.
 *  - using hu.txt: A keresett eljárás (ExampleMethod) nem található.
 */
throw new Exception(sprintf(Language::Get('not_found'), $name));

/**
 * throws exception with message ($param_index = 3, $name = "ExampleMethod"):
 *  - using en.txt: Bad argument 3 for function ExampleMethod.
 *  - using hu.txt: Érvénytelen 3. paraméter a(z) ExampleMethod eljárás hívásakor.
 */
throw new Exception(sprintf(Language::Get('bad_arg_no'), $param_index, $name));

Nó cũng đi kèm với các khả năng đầy đủ của printf, do đó, cũng là một lớp lót để định dạng nhiều loại biến, ví dụ:

• độ chính xác đầu ra số dấu phẩy động , hoặc
• điền số nguyên với số không hàng đầu .

Như đã đề cập, nó cho phép định dạng dữ liệu đầu vào. Ví dụ: buộc các số 2dp, 4 chữ số, v.v ... Nó khá hữu ích để xây dựng chuỗi truy vấn MySQL.

Một ưu điểm khác là nó cho phép bạn tách biệt bố cục của chuỗi khỏi dữ liệu được đưa vào nó, gần giống như cho ăn trong các thông số. Ví dụ: trong trường hợp truy vấn MySQL:

// For security, you MUST sanitise ALL user input first, eg:
$username = mysql_real_escape_string($_POST['username']); // etc.
// Now creating the query:
$query = sprintf("INSERT INTO `Users` SET `user`='%s',`password`='%s',`realname`='%s';", $username, $passwd_hash, $realname);

Phương pháp này tất nhiên có những cách sử dụng khác, chẳng hạn như khi in đầu ra dưới dạng HTML, v.v.

Chỉnh sửa: Vì lý do bảo mật , khi sử dụng một kỹ thuật như trên, bạn phải vệ sinh tất cả các biến đầu vào mysql_real_escape_string()trước khi sử dụng phương pháp này , để ngăn chặn các cuộc tấn công chèn MySQL. Nếu bạn phân tích cú pháp đầu vào không được xác nhận, trang web và máy chủ của bạn sẽ bị hack . (Tất nhiên, ngoại trừ, các biến đã được xây dựng hoàn toàn bởi mã của bạn và được đảm bảo an toàn.)

Sử dụng sprintf () sẽ sạch hơn và an toàn hơn để định dạng chuỗi của bạn.

Ví dụ: khi bạn đang xử lý các biến đầu vào, nó sẽ ngăn chặn những bất ngờ không mong muốn bằng cách chỉ định trước định dạng dự kiến ​​(ví dụ: bạn đang mong đợi chuỗi [ %s] hoặc số [ %d]). Điều này có khả năng giúp giảm nguy cơ SQL SQL , nhưng sẽ không ngăn được nếu chuỗi bao gồm dấu ngoặc kép.

Nó cũng giúp xử lý các float, bạn có thể chỉ định rõ ràng độ chính xác của chữ số (ví dụ %.2f) giúp bạn tiết kiệm khi sử dụng các hàm chuyển đổi.

Ưu điểm khác là hầu hết các ngôn ngữ lập trình chính đều có cách triển khai riêng sprintf() , vì vậy khi bạn đã quen với nó, việc sử dụng nó sẽ dễ dàng hơn, thay vì học một ngôn ngữ mới (như cách nối chuỗi hoặc chuyển đổi phao).

Tóm lại, đó là một cách thực hành tốt để sử dụng để có mã dễ đọc và dễ đọc hơn.

Ví dụ, xem ví dụ thực tế dưới đây :

$insert .= "('".$tr[0]."','".$tr[0]."','".$tr[0]."','".$tr[0]."'),";

Hoặc một số ví dụ đơn giản mà in, ví dụ '1','2','3','4':

print "foo: '" . $a . "','" . $b . "'; bar: '" . $c . "','" . $d . "'" . "\n";

và in với chuỗi định dạng:

printf("foo: '%d','%d'; bar: '%d','%d'\n", $a, $b, $c, $d);

nơi printf()tương đương vớisprintf() , nhưng nó đưa ra một chuỗi được định dạng thay vì trả về nó (cho biến).

Cái nào dễ đọc hơn?

Ngay cả tôi mặc dù điều tương tự trừ khi tôi sử dụng nó gần đây. Khi bạn tạo tài liệu dựa trên đầu vào của người dùng, điều này sẽ có ích.

"<p>Some big paragraph ".$a["name"]." again have tot ake care of space and stuff .". $a["age"]. "also would be hard to keep track of punctuations and stuff in a really ".$a["token"]. paragarapoh.";

Những gì có thể dễ dàng được viết là

sprintf("Some big paragraph %s. Again have to take care of space and stuff.%s also wouldnt be hard to keep track of punctuations and stuff in a really %s paragraph",$a,$b,$c);

Điều này:

"<p>Some big paragraph ".$a["name"]." again have to take care of space and stuff .". $a["age"]. "also would be hard to keep track of punctuations and stuff in a really ".$a["token"]. paragraph.";

Cũng có thể được viết:

"<p>Some big paragraph {$a['name']} again have to take care of space and stuff .{$a['age']} also would be hard to keep track of punctuations and stuff in a really {$a['token']} paragraph.";

Theo ý kiến ​​của tôi, điều này rõ ràng hơn để đọc, nhưng tôi có thể thấy việc sử dụng để bản địa hóa hoặc định dạng.

Một số trường hợp điển hình là nơi bạn cần kiểm soát chính xác hơn định dạng đầu ra. Chẳng hạn, có thể khó để đảm bảo một giá trị cụ thể có lượng không gian cụ thể được đệm ở phía trước, tùy thuộc vào độ dài của nó hoặc một số được xuất ra theo một định dạng chính xác cụ thể.

Có rất nhiều ví dụ trong hướng dẫn PHP

Ngoài ra những gì đến với ví dụ của bạn về "dễ viết hơn" .. Trong khi tiếng vang có thể dễ viết hơn, sprintf dễ đọc hơn, đặc biệt nếu bạn có nhiều biến.

Một lý do khác để sử dụng sprintf hoặc printf có thể là bạn muốn cho phép người dùng xác định định dạng đầu ra của một số giá trị - bạn có thể cho phép họ xác định định dạng đầu ra tương thích sprintf một cách an toàn.

Oh, và ví dụ của bạn thực sự sai cho một phần. sprintftrả về chuỗi, nhưng echokhông - echongay lập tức xuất ra chuỗi và không trả về gì, trong khi sprintfchỉ trả về chuỗi .

1. Nếu bạn đã sử dụng C / C ++, thì bạn sẽ được sử dụng chức năng sprintf.

2. Có một cơ hội tốt là dòng thứ hai kém hiệu quả hơn. Echo được thiết kế như một lệnh đầu ra, trong khi sprintf được thiết kế để thực hiện thay thế mã thông báo chuỗi. Tôi không phải là người PHP, nhưng tôi nghi ngờ rằng có nhiều đối tượng liên quan đến tiếng vang. Nếu nó hoạt động như Java, nó sẽ tạo ra một chuỗi mới mỗi khi một cái gì đó được thêm vào danh sách, vì vậy bạn sẽ kết thúc với 4 chuỗi được tạo.

Đôi khi tôi nhận được một cái gì đó như thế này, mà tôi cho rằng dễ đọc hơn một chút:

$fileName = sprintf('thumb_%s.%s', 
                    $fileId,
                    $fileInfo['extension']);

Tôi thường sử dụng sprintf để đảm bảo rằng một id đến từ đầu vào của người dùng là một số nguyên chẳng hạn:

// is better use prepared statements, but this is practical sometimes
$query = sprintf("SELECT * from articles where id = %d;",$_GET['article_id']);

Cũng được sử dụng để làm các mẫu thô sơ (đối với thư html hoặc những thứ khác), vì vậy bạn có thể sử dụng lại mẫu ở nhiều nơi:

$mail_body = "Hello %s, ...";
$oneMail = sprintf($mail_body, "Victor");
$anotherMail = sprintf($mail_body, "Juan");

Nó cũng rất hữu ích để định dạng số trong các biểu diễn khác nhau (bát phân, kiểm soát vị trí thập phân, v.v.).

define('TEXT_MESSAGE', 'The variable "%s" is in the middle!');

sprintf(TEXT_MESSAGE, "Var1");
sprintf(TEXT_MESSAGE, "Var2");
sprintf(TEXT_MESSAGE, "Var3");

sprintf đặc biệt hữu ích khi định dạng chuỗi sử dụng số. Ví dụ,

$oranges = -2.34;
echo sprintf("There are %d oranges in the basket", $oranges);

Output: There are -2 oranges in the basket

Cam được định dạng dưới dạng một số nguyên (-2), nhưng sẽ bao quanh các số dương nếu người ta sử dụng% u cho các giá trị không dấu. Để tránh hành vi này, tôi sử dụng hàm tuyệt đối, abs (), để làm tròn số về 0 như sau:

$oranges = -5.67;
echo sprintf("There are %d oranges in the basket", abs($oranges));

Output: There are 5 oranges in the basket

Kết quả cuối cùng là một tuyên bố có khả năng đọc cao, xây dựng logic, định dạng rõ ràng và linh hoạt để thêm các biến bổ sung theo yêu cầu. Khi số lượng biến tăng kết hợp với các hàm thao túng các biến này, lợi ích sẽ trở nên rõ ràng hơn. Như một ví dụ cuối cùng:

$oranges = -3.14;
$apples = 1.5;
echo sprintf("There are %d oranges and %d apples", abs($oranges), abs($apples));

Output: There are 3 oranges and 4 apples

Phía bên trái của câu lệnh sprintf thể hiện rõ ràng chuỗi và các loại giá trị dự kiến, trong khi phía bên phải thể hiện rõ ràng các biến được sử dụng và cách chúng được thao tác.

Vâng, sprintf có nhiều khả năng như chúng ta biết một ví dụ như dưới đây:

Vài tháng trước tôi có nhu cầu chuyển đổi định dạng giây sang giờ: phút: giây $t = 494050 //secondsTôi muốn in như 137 h 14 m 10 svậy nên tôi đã đưa ra chức năng php springf()tôi chỉ giữ giây trong $tvà echo sprintf("%02d h %s%02d m %s%02d s", floor($t/3600), $f, ($t/60)%60, $f, $t%60);đưa cho tôi137 h 14 m 10 s

Hàm sprintf () rất hữu ích nếu chúng ta biết cách sử dụng nó.

Đối số là cùng một đối với việc sử dụng các mẫu. Bạn sẽ muốn tách Textsleev của bạn khỏi các giá trị biến thực tế. Bên cạnh sức mạnh bổ sung của chạy nước rút mà chúng tôi đã đề cập về nó chỉ là một phong cách.

Một trường hợp sử dụng thực sự tốt để sử dụng sprintf là xuất ra các định dạng đệm của các số và cả khi trộn các loại khác nhau trong một chuỗi. Nó có thể dễ đọc hơn trong nhiều trường hợp và làm cho nó cực kỳ đơn giản để in các biểu diễn khác nhau của cùng một biến, đặc biệt là các số.

Sử dụng hàm sprintf () so với phép nối thông thường có lợi thế là bạn có thể áp dụng các loại định dạng khác nhau trên các biến được nối.

Trong trường hợp của bạn, bạn có

$output = sprintf("Here is the result: %s for this date %s", $result, $date);

và

$output = 'Here is the result: ' .$result. ' for this date ' .$date;

Hãy để chúng tôi lấy $result = 'passed'; date = '23rd';

Sử dụng phép nối thông thường, bạn chỉ có thể nhận được đầu ra:

Here is the result: passed for this date 23rd

Tuy nhiên, nếu bạn sử dụng, sprintf()bạn có thể nhận được một đầu ra sửa đổi, chẳng hạn như:

$output = sprintf('Here is the result: %.4s for this date %.2s',$result,$date);
echo $output;

Đầu ra:

Here is the result: pass for this date 23

sprintf()khá giống với printf(). Nếu bạn biết printf()chi tiết sau đó sprintf()và thậm chí vsprintf()không thực sự khó hiểu.

một trong những điều đó khác với sprintf()từ printf()là bạn sẽ không cần khai báo một biến để bắt đầu ra khỏi chức năng vì nó không trực tiếp in / echo bất cứ điều gì. Hãy xem đoạn mã sau:

printf("Hello %s", "world"); // "Hello world"

sprintf("Hello %s", "world"); // does not display anything

echo sprintf("Hello %s", "world"); // "Hello world"

$a = sprintf("Hello %s", "world"); // does not display anything

echo $a;// "Hello world"

Mong rằng sẽ giúp.

Một "đầu ra", "trả về" khác, đó là một trong những khác biệt chính.

printf() Đầu ra

sprintf() Trả về

Bạn phải cẩn thận khi sử dụng sprintf trong các vòng lặp:

$a = 'Anton';
$b = 'Bert';
$c = 'Corni';
$d = 'Dora';
$e = 'Emiel';
$f = 'Falk';
$loops = 10000000;

$time = microtime(true);

for ($i = 0; $i < $loops; $i++)
{
    $test = $a . $b . $c . $d . $e . $f;
}

$concatTime = microtime(true) - $time;

$time = microtime(true);

for ($i = 0; $i < $loops; $i++)
{
    $test = "$a $b $c $d $e $f";
}

$concat2Time = microtime(true) - $time;

$time = microtime(true);

for ($i = 0; $i < $loops; $i++)
{
    $test = sprintf('%s %s %s %s %s %s', $a, $b, $c, $d, $e, $f);
}

$sprintfTime = microtime(true) - $time;

echo 'Loops: ' . $loops . '<br>';
echo '\'$a . $b . $c . $d . $e . $f\'' . ' needs ' . $concatTime  . 's<br>';
echo '"$a $b $c $d $e $f"' . ' needs ' . $concat2Time  . 's<br>';
echo 'sprintf(\'%s %s %s %s %s %s\', $a, $b, $c, $d, $e, $f)' . ' needs ' . $sprintfTime  . 's<br>';

Điều này dẫn đến những lần sau (trên máy cục bộ của tôi với PHP 7.2):

Vòng lặp: 10000000

'$ a. $ b. $ c. $ d. $ e. $ f 'cần 1.4507689476013s

"$ a $ b $ c $ d $ e $ f" cần 1.9958319664001s

sprintf ('% s% s% s% s% s% s', $ a, $ b, $ c, $ d, $ e, $ f) cần 9.1771278381348s

Tôi sử dụng nó cho các tin nhắn cho người dùng hoặc các loại chức năng "đẹp" khác. Ví dụ, nếu tôi biết tôi sẽ sử dụng tên người dùng.

$name = 'Some dynamic name';

Và có nhiều tin nhắn để sử dụng trong tình huống đó. (Tức là, chặn hoặc theo dõi người dùng khác)

$messageBlock = 'You have blocked %s from accessing you.';
$messageFollow = 'Following %s is a great idea!';

Bạn có thể tạo một hàm chung thực hiện một cái gì đó cho người dùng và thêm chuỗi này, và cho dù cấu trúc của câu đó trông như thế nào cũng khá đẹp. Tôi luôn không thích chỉ nối các chuỗi lại với nhau và liên tục sử dụng ký hiệu dấu chấm và đóng và mở lại chuỗi chỉ để làm cho một câu có vẻ tốt. Lúc đầu tôi là một người hâm mộ giống như hầu hết nhưng điều này có vẻ khá hữu ích khi nhiều chuỗi cần phải được thao tác và bạn không muốn mã hóa vị trí của biến trong mỗi lần.

Hãy nghĩ về nó, những gì có vẻ tốt hơn?

return $messageOne === true ? $name.'. Please use the next example' : 'Hi '.$name.', how are you?'

Hoặc là

$message = $messageOne === true ? 'Option one %s' 
: ($messageTwo === true ? 'Option Two %s maybe?' : '%s you can choose from tons of grammatical instances and not have to edit variable placement and strings');

return sprintf($message, $name);

Chắc chắn đó là một bước bổ sung nhưng nếu kiểm tra có điều kiện của bạn thực hiện một loạt các chức năng khác, thì các trích dẫn và nối thêm bắt đầu có được theo cách mã hóa theo chức năng.