%PDF- %PDF-
| Direktori : /www/loslex_o/tracker/core/commands/ |
| Current File : /www/loslex_o/tracker/core/commands/IssueFileAddCommand.php |
<?php
# MantisBT - A PHP based bugtracking system
# MantisBT is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 2 of the License, or
# (at your option) any later version.
#
# MantisBT is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with MantisBT. If not, see <http://www.gnu.org/licenses/>.
require_api( 'authentication_api.php' );
require_api( 'bug_api.php' );
require_api( 'constant_inc.php' );
require_api( 'config_api.php' );
require_api( 'helper_api.php' );
require_api( 'user_api.php' );
use Mantis\Exceptions\ClientException;
/**
* Command data
* - In files, `error` and `size` are used only by web UI.
* - Reporter is optional, it is defaulted to logged in user.
*
* Sample:
* {
* "query": {
* "issue_id": 12345
* },
* "payload": {
* "reporter": {
* "name": "vboctor"
* },
* "files": [
* {
* "name": "filename.ext",
* "type": "application/...",
* "tmp_name": "/tmp/php/phpRELws8",
* "error": 0,
* "size": 114
* }
* ]
* }
* }
*/
/**
* A command that adds an issue attachment.
*/
class IssueFileAddCommand extends Command {
/**
* The issue to add the note to.
*
* @var BugData
*/
private $issue = null;
/**
* @var integer
*/
private $user_id;
/**
* The files to attach with the note.
*/
private $files = array();
/**
* The reporter id for the note.
*/
private $reporterId = 0;
/**
* Constructor
*
* @param array $p_data The command data.
*/
function __construct( array $p_data ) {
parent::__construct( $p_data );
}
/**
* Validate the data.
*/
function validate() {
$t_issue_id = helper_parse_issue_id( $this->query( 'issue_id' ) );
$this->issue = bug_get( $t_issue_id, true );
if( bug_is_readonly( $t_issue_id ) ) {
throw new ClientException(
sprintf( "Issue '%d' is read-only.", $t_issue_id ),
ERROR_BUG_READ_ONLY_ACTION_DENIED,
array( $t_issue_id ) );
}
$this->parseFiles();
$t_files_included = !empty( $this->files );
if( !$t_files_included ) {
throw new ClientException(
'Files not provided',
ERROR_INVALID_FIELD_VALUE,
array( 'files' ) );
}
$this->user_id = auth_get_current_user_id();
# Parse reporter id or default it.
$t_reporter = $this->payload( 'reporter' );
if( $t_reporter !== null ) {
$this->reporterId = user_get_id_by_user_info(
$t_reporter, /* throw_if_id_doesnt_exist */ true );
} else {
$this->reporterId = $this->user_id;
}
if( $this->reporterId != $this->user_id ) {
# Make sure that active user has access level required to specify a different reporter.
# This feature is only available in the API and not Web UI.
$t_specify_reporter_access_level = config_get( 'webservice_specify_reporter_on_add_access_level_threshold' );
if( !access_has_bug_level( $t_specify_reporter_access_level, $t_issue_id ) ) {
throw new ClientException( 'Access denied to override reporter', ERROR_ACCESS_DENIED );
}
}
# Can reporter attach files
if( !file_allow_bug_upload( $this->issue->id, $this->reporterId ) ) {
throw new ClientException( 'access denied for uploading files', ERROR_ACCESS_DENIED );
}
}
/**
* Process the command.
*
* @returns array Command response
*/
protected function process() {
if( $this->issue->project_id != helper_get_current_project() ) {
# in case the current project is not the same project of the bug we are
# viewing, override the current project. This to avoid problems with
# categories and handlers lists etc.
global $g_project_override;
$g_project_override = $this->issue->project_id;
}
# Handle the file upload
file_attach_files( $this->issue->id, $this->files );
return array();
}
/**
* Parse files from payload.
* @return void
*/
private function parseFiles() {
$this->files = $this->payload( 'files', array() );
if( !is_array( $this->files ) ) {
$this->files = array();
}
$t_files_required_fields = array( 'name', 'tmp_name' );
foreach( $this->files as $t_file ) {
foreach( $t_files_required_fields as $t_field ) {
if( !isset( $t_file[$t_field] ) ) {
throw new ClientException(
sprintf( "File field '%s' is missing.", $t_field ),
ERROR_EMPTY_FIELD,
array( $t_field ) );
}
}
}
}
}