PHP 주석-PHP 튜토리얼-php.cn

PHP 주석

PHPz

풀어 주다： 2024-08-29 13:02:09

원래의

767명이 탐색했습니다.

PHP 주석은 기본적으로 소스 코드와 클래스, 함수, 속성 및 메서드 사이에 포함될 수 있는 메타데이터입니다. 선언된 위치마다 @ 접두사로 시작되며 특정 내용을 나타냅니다. 그들이 제공하는 이 정보는 코더에게 매우 유용하며 문서화 목적에 도움이 되며 IDE는 이를 사용하여 특정 팝업 힌트 종류를 표시할 수도 있습니다. 동일한 주석은 유효성 검사 외에도 양식에 어떤 종류의 입력을 제공해야 하는지 결정하고 자동화 목적으로 사용하는 등 다른 목적으로도 사용될 수 있습니다. 이름 자체에서 알 수 있듯이 특정 용도로 사용할 수 있는 @var 및 @int 유형과 같은 다양한 종류의 주석이 있습니다.

광고 이 카테고리에서 인기 있는 강좌 PHP 개발자 - 전문 분야 | 8개 코스 시리즈 | 3가지 모의고사

무료 소프트웨어 개발 과정 시작

웹 개발, 프로그래밍 언어, 소프트웨어 테스팅 등

구문

PHP 주석은 @ 접두사를 붙여 사용하며 구문은 다음과 같습니다.

class Example
{
// @var integer
public $new;
}

로그인 후 복사

여기서 주석은 @var이며 코드 조각(예: 여기에서는 public $new) 바로 앞에 나타날 때마다 $new가 주석에서 알 수 있듯이 정수 유형의 값을 갖는다는 것을 나타냅니다.

class Example
{
// @var integer
// @range(0, 51)
// @label('Count of shops')
public $shop;
}

로그인 후 복사

주석은 함수의 정수 값으로 허용되는 최대값과 최소값을 표시하는 범위를 지정하는 데 사용할 수도 있으며 레이블은 이 함수의 목적을 제공합니다.

PHP 주석 유형

다음은 유형입니다.

1. 내장된 주석

주석에는 다음과 같은 2가지 내장 기능이 있습니다.

아. 컴파일됨: 이 주석은 메서드/함수가 JIT 컴파일되어야 하는지 여부를 나타냅니다. 함수 범위 유형의 주석이기도 합니다.

ㄴ. SuppressWarnings: 이는 아래 후속 코드 실행의 일부로 발생하는 모든 경고를 억제해야 함을 의미하는 또 다른 내장 주석입니다.

2. 메타 주석

다른 주석을 적용하는 데 사용할 수 있는 주석 유형입니다. 주석 구성에 사용됩니다.

아. @주석

@annotation을 포함하는 일종의 주석 클래스가 있습니다.

코드:

[@Annotation]
class MyAnnoExample {
// piece of code
}

로그인 후 복사

ㄴ. @타겟

이름에서 알 수 있듯이 이 주석은 해당 주석이 적용될 수 있는 클래스 요소 유형이나 메서드를 나타냅니다.

이에 따라 하나 이상의 대상을 설명할 수 있습니다.

속성 주석은 속성 클래스 선언 바로 앞에 있습니다.
수업 선언 전 허용되는 수업입니다.
함수 선언 전에 함수가 선언되었습니다.
메소드 주석을 사용하면 메소드 선언을 진행할 수 있습니다.
Annotation 클래스 선언으로 진행하려면 Annotation을 허용합니다.

ㄷ. @Repeatable

이 주석은 사용될 때 여러 번 반복될 수 있음을 의미합니다.

디. @상속됨

다른 사용자 정의 주석 클래스에서 메타 주석으로 사용할 수도 있습니다. 이러한 상속된 주석은 슈퍼클래스에서 사용될 때 각 하위 클래스에 자동으로 상속됩니다.

3. 사용자 정의 주석

이것은 일반 클래스의 선언과 매우 유사합니다. 주석 유형의 각 요소는 각 속성 선언에 의해 정의됩니다.

PHP 주석의 예

다음은 언급된 예입니다.

예시 #1

코드:

// namespace declaration here
[@Annotation]
[@Target("class")]
class MyAnnoEx {
[@Required]
public string $prop;
public array $arrayProp = [];
public embedAnno $embed;
}
[@Annotation]
// code for embedded annotation goes here
[@Target(["class", "annotation"])]
class embedAnno {
}
[@Annotation]
// example for target annotation
[@Target("property")]
class propAnno {
}
@Annotation
// code for method annotation goes here
@Target("method")
class methodAnno {
public string $val;
public function __construct(string $val) {
$this->val = $val;
}
}

로그인 후 복사

이것은 위에 표시된 다양한 유형의 주석의 사용법을 보여주는 기본적인 예일 뿐입니다. 삽입 주석, 속성 주석, 메소드 주석과 같은 예제의 모든 주석은 사용자 정의 주석입니다.

예시 #2

코드:

<!DOCTYPE html>
<html>
<body>
<?php
/**
* @Replace("exmaple", "for", "annotation")
*/
class MyNamedComponent
{
}
echo str_replace("First", "Second", "First Example");
?>
</body>
</html>

로그인 후 복사

출력:

PHP 주석

이 예에서는 아래 코드가 PHP에 내장된 함수인 str_replace인 문자열 바꾸기 함수의 사용법을 나타내기 때문에 주석 이름을 바꾸기로 지정합니다. 이 함수를 사용하면 함수에 전달된 첫 번째 매개변수가 두 번째 매개변수로 대체됩니다.

예시 #3

코드:

<!DOCTYPE html>
<html>
<head>
<title>Simple Form Processing</title>
</head>
<body>
<h1>Form Processing using PHP</h1>
<fieldset>
<form id="formex1" method="post" action="formexample.php">
<!--Declaring First name for the form
@Annotation text first_name-->
First_Name:
<input type="text" name="First_Name"/>
<!--@var style color-->
<span style="color:blue;">*</span>
<br>
<br>
<!--Declaring Last_Name for the form
@Annotation text last_name-->
Last_Name:
<input type="text" name="last_name"/>
<span style="color:blue;">*</span>
<br>
<br>
<!--Declaring Location for the form
@Annotation text location-->
Stay location:
<input type="text" name="location"/>
<span style="color:blue;">*</span>
<br>
<br>
<!--Declaring EMAILID for the form
@Annotation text email-->
EmailID:
<input type="email" name="emailID"/>
<span style="color:blue;">*</span>
<br>
<br>
<!--Declaring Password for the form
@Annotation password-->
Password:
<input type="password" name="password"/>
<span style="color:blue;">*</span>
<br>
<br>
<!--Declaring Password for the form
@Radio button password-->
Gender:
<!-- Gender to be selected as either male or female -->
<input type="radio"
value="Male"
name="gender"> Male
<input type="radio"
value="Female"
name="gender">Female
<br>
<br>
<input type="confirm" value="confirm" name="confirm" />
</form>
</fieldset>
<?php
if(example($_POST['confirm']))
{
if(!example($error))
{
echo"<h1>DETAILS RECEIVED</h1><br>";
echo "<table border='2'>";
echo "<thead>";
echo "<th>Argument</th>";
echo "<th>Value</th>";
echo "</thead>";
echo "<tr>";
echo "<td>First Name</td>";
echo "<td>".$First_Name."</td>";
echo "</tr>";
echo "<tr>";
echo "<td>Last_Name</td>";
echo "<td>".$last_name."</td>";
echo "</tr>";
echo "<tr>";
echo "<td>Stay location</td>";
echo "<td>".$location."</td>";
echo "</tr>";
echo "<tr>";
echo "<td>Email Stay location</td>";
echo "<td>" .$emailID."</td>";
echo "</tr>";
echo "<tr>";
echo "<td>Password</td>";
echo "<td>".$password."</td>";
echo "</tr>";
echo "<tr>";
echo "<td>Gender</td>";
echo "<td>".$gender."</td>";
echo "</tr>";
echo "</table>";
}
}
?>
</body>
</html>

로그인 후 복사

출력:

PHP 주석

이 예에서는 PHP의 양식 유효성 검사와 함께 주석을 표시하고 있습니다. 주석을 사용하여 이름과 성, 이메일, 위치, 비밀번호 등 양식에 대한 입력 매개변수로 필요한 모든 매개변수에 라벨을 지정합니다.

결론

위의 예를 통해 우리는 주석이 메서드, 클래스 또는 속성에 대한 메타데이터를 사용하고 표현하는 강력한 도구라는 점을 확인했습니다. 또한 다양한 종류의 주석을 결합하여 특정 작업에 대한 메타데이터를 작성하여 특정 작업을 수행할 작업자를 선언하는 방법도 살펴보았습니다. 이렇게 하면 쉽게 찾을 수 있고 사용 가능 여부에 대한 실제 정보를 얻을 수 있습니다.

위 내용은 PHP 주석의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!