2014-09-01 6 views
2

저는 swagger를 사용하여 PHP 프로젝트를 문서화해야합니다. 그러나 기존 MVC 패턴을 따르지 않으며 대신 데이터를 가져 오거나 가져 와서 뭔가를 반환하는 정적 파일을 포함합니다.Swagger-PHP 모델을 읽을 수 없습니다.

리소스는 일반적으로 json 파일 내부에서 생성되지만, 어떤 이유로 든 내가 만든 모델이 렌더링되지 않습니다. 여기에 내 파일 중 하나 내부에 배치 될지의 예입니다 :이 문제는 모델 섹션은 항상 건너 해결

/*@SWG\Resource(
* basePath="mypath", 
* resourcePath="/resource", 
* produces="['application/json']", 
* @SWG\Api(
*  path="resource", 
*  @SWG\Operation(
*   method="POST", 
*   type="void", 
*   summary="Submit a json thing", 
*   @SWG\Consumes("application/json"), 
*   @SWG\Parameter(
*    name="body", 
*    description="The json containing information", 
*    type="CLASS", 
*    required=true, 
*    paramType="body" 
*   ), 
*   nickname="resource" 
*  ) 
* ) 
*) 
*/ 


/** 
* @SWG\Model(id="CLASS", @SWG\Property(name="name", type="string")) 
*/ 

, 그리고 내 JSON 파일에 구현 된 모델 스키마를 얻을 수 없습니다입니다 .

새로운 문제 내 서버에 따라, 중 메모리 오류 또는 자신감 포장 마차의 부족을 얻고있다 : 내 개인 서버에서

, 내가 기록하려고 할 때, 그것은 지연 중/포장 마차, 오류 메시지가 표시되지 않습니다 (Swagger-php 저장소의 예제 구현에서는 발생하지 않음). 실제 서버에있을 때 메모리 부족 오류가 발생합니다. PHP 치명적 오류 : phar : ///usr/local/bin/swagger.phar에 메모리가 부족합니다 (할당 된 -1202716672) (261900 바이트 할당 시도). /library/Swagger/Swagger.php on line 668

문서화에 관해서는 명령 줄에서 swagger.phar 파일을 사용합니다.

모델을 표시하는 방법에 대한 도움이 필요합니다. 고맙습니다.

답변

2

자신감-PHP는 /**

코멘트가 ingored하는 /*//로 시작부터 시작 T_DOC_COMMENT s로 보인다.

+0

아하겠습니다. 여분의 별표를 추가했는데 메모리 오류가 발생했습니다 : PHP 치명적 오류 : phar : /// usr/local/bin/swagger에서 메모리가 부족합니다 (할당 된 -1202716672) (할당 된 261900 바이트). .phar/library/Swagger/Swagger.php on line 668 이것은 @SWG \ Model 선언을 포함 할 때만 발생합니다. – user3855005

+0

제 개인 서버에서 Im은 github 저장소에 제공된 예제를 사용하여 문서를 만들 수 있지만 파일을 사용할 때는 작동하지 않습니다. 나는 그 때문에 기억 문제라고 생각하지 않는다. 비록 내가 틀렸다면 나를 교정 해 주겠다. 구문 오류가있는 것 같아요. 오히려 제가 잘 모르고 있다고 잘못 생각하고있는 것 같습니다. 필자는 저장소 및 주석 페이지의 예제를 최대한 가깝게 시도했습니다. – user3855005

+0

개인용 서버의 상단에있는 게시물에 관한 간단한 업데이트, 문서 작성을 시도 할 때/stalls가 발생하며 오류 메시지가 표시되지 않습니다 (Swagger-php 리포지토리의 예제 구현에서는 발생하지 않습니다.). 실제 서버에있을 때 메모리 부족 오류가 발생합니다. 실제 서버의 메모리 할당은 내 개인보다 훨씬 깁니다. 그래서 나는이 오류가 실제 서버에서만 보이고 내 서버에서는 보이지 않는 이유에 대해 다소 혼란 스럽습니다. – user3855005