grep -c expContentWriter autoload/ezp_kernel.php

php bin/php/ezexec.php extension/exp_mysite/scripts/first_create.php

<?php
$user = eZUser::fetchByName( 'exp_importer' );
if ( !$user instanceof eZUser )
{
    eZCLI::instance()->error( 'The user exp_importer does not exist' );
    return;
}
eZUser::setCurrentlyLoggedInUser( $user, $user->attribute( 'contentobject_id' ) );

<?php
$cli = eZCLI::instance();
$user = eZUser::fetchByName( 'exp_importer' );
eZUser::setCurrentlyLoggedInUser( $user, $user->attribute( 'contentobject_id' ) );

$result = expContentWriter::create( array(
    'parentNodeID'    => 2,
    'classIdentifier' => 'folder',
    'languageLocale'  => 'eng-US',
    'remoteID'        => 'exp-mysite-press-folder',
    'attributes'      => array(
        'name'              => 'Press',
        'short_description' => '<p>News for <em>journalists</em>.</p>',
    ),
) );

$cli->output( $result['status'] . ': ' . $result['message'] );
if ( $result['object'] instanceof eZContentObject )
    $cli->output( 'Object ' . $result['object']->attribute( 'id' ) . ', node ' . $result['object']->attribute( 'main_node_id' ) );

php bin/php/ezexec.php extension/exp_mysite/scripts/first_create.php

published: Created
Object <object id>, node <node id>

<?php
function exp_mysite_written( array $result, eZCLI $cli )
{
    switch ( $result['status'] )
    {
        case 'published':
            return true;
        case 'pending':
            // a workflow (an approval, for example) holds the version; it is published when the workflow ends
            $cli->warning( $result['message'] . ' (version ' . $result['version'] . ')' );
            return true;
        case 'invalid':
            // nothing was written: an unknown class, attribute, language or parent, a value that is not text,
            // a file that is not a public address, a remote id that exists already
            $cli->error( 'Refused: ' . $result['message'] );
            return false;
        default: // failed
            // the write failed half way and was rolled back; the reason is in the debug log
            $cli->error( 'Failed: ' . $result['message'] );
            return false;
    }
}

<?php
$object = eZContentObject::fetchByRemoteID( 'exp-mysite-press-folder' );
if ( !$object instanceof eZContentObject )
    return;

// change one attribute; the others keep their values
$result = expContentWriter::update( $object, array( 'name' => 'Press and media' ), 'eng-US' );

// add a German translation: a language the object does not have yet becomes a new translation
$result = expContentWriter::update( $object, array(
    'name'              => 'Presse und Medien',
    'short_description' => '<p>Neuigkeiten für die <em>Presse</em>.</p>',
), 'ger-DE' );

<?php
$object = eZContentObject::fetchByRemoteID( 'exp-mysite-press-folder' );
if ( $object instanceof eZContentObject )
{
    $result = expContentWriter::remove( $object, true );   // true: to the trash; false (default): deleted
}

<?php
$cli = eZCLI::instance();
$dryRun = in_array( '--dry-run', $_SERVER['argv'], true );
$file = 'var/import/events.csv';
$parentNodeID = 2; // replace with the node id of your folder Events

$user = eZUser::fetchByName( 'exp_importer' );
eZUser::setCurrentlyLoggedInUser( $user, $user->attribute( 'contentobject_id' ) );

$handle = fopen( $file, 'r' );
if ( !$handle )
{
    $cli->error( "Cannot read $file" );
    return;
}
fgetcsv( $handle, 0, ',', '"', '\\' ); // the header line
$counts = array( 'created' => 0, 'updated' => 0, 'unchanged' => 0, 'refused' => 0 );
$row = 0;
while ( ( $line = fgetcsv( $handle, 0, ',', '"', '\\' ) ) !== false )
{
    ++$row;
    list( $id, $title, $introHtml, $start, $imageUrl ) = $line;
    $remoteID = 'exp-mysite-event-' . $id;
    $values = array(
        'title'      => $title,
        'intro'      => $introHtml,
        'start_date' => (string)strtotime( $start ),
        'image'      => $imageUrl !== '' ? $imageUrl . '|' . $title : '',
    );

    $object = eZContentObject::fetchByRemoteID( $remoteID );
    if ( $dryRun )
    {
        $cli->output( ( $object ? 'would update ' : 'would create ' ) . $remoteID );
        continue;
    }
    if ( $object instanceof eZContentObject )
    {
        // write only what changed, so an unchanged record makes no new version
        $dataMap = $object->dataMap();
        $changed = array();
        foreach ( array( 'title', 'start_date' ) as $identifier )
            if ( $dataMap[$identifier]->toString() !== $values[$identifier] )
                $changed[$identifier] = $values[$identifier];
        if ( !$changed )
        {
            ++$counts['unchanged'];
            continue;
        }
        $result = expContentWriter::update( $object, $changed, 'eng-US' );
        $key = 'updated';
    }
    else
    {
        $result = expContentWriter::create( array( 'parentNodeID' => $parentNodeID, 'classIdentifier' => 'exp_event',
                                                   'languageLocale' => 'eng-US', 'remoteID' => $remoteID,
                                                   'attributes' => $values ) );
        $key = 'created';
    }
    if ( $result['status'] === 'published' || $result['status'] === 'pending' )
        ++$counts[$key];
    else
    {
        ++$counts['refused'];
        $cli->error( "Row $row ($remoteID): " . $result['message'] );
    }
    if ( $row % 100 === 0 )
        eZContentObject::clearCache(); // keeps memory flat on long runs
}
fclose( $handle );
$cli->output( json_encode( $counts ) );

php bin/php/ezexec.php extension/exp_mysite/scripts/import_events.php --dry-run   # what it would do
php bin/php/ezexec.php extension/exp_mysite/scripts/import_events.php             # the import

<?php
// description: The folder Press releases below the content root
namespace Site\Migrations;

final class PressReleasesFolder20261112100000 extends \expMigrationPhp
{
    const REMOTE_ID = 'site-press-releases-folder';

    public function plan( $context )
    {
        return array( 'publish the folder Press releases below node 2 (remote id ' . self::REMOTE_ID . ')' );
    }

    public function detect( $context )
    {
        return \eZContentObject::fetchByRemoteID( self::REMOTE_ID ) instanceof \eZContentObject ? \expMigration::DONE : null;
    }

    public function up( $context )
    {
        $result = \expContentWriter::create( array(
            'parentNodeID'    => 2,
            'classIdentifier' => 'folder',
            'languageLocale'  => 'eng-US',
            'remoteID'        => self::REMOTE_ID,
            'attributes'      => array( 'name' => 'Press releases' ),
        ) );
        if ( $result['status'] !== 'published' )
            throw new \RuntimeException( 'the folder Press releases was not published: ' . $result['message'] );
        $context->setReference( 'press_releases_node', (int)$result['object']->attribute( 'main_node_id' ) );
        return array( 'published the folder Press releases (object ' . $result['object']->attribute( 'id' ) . ')' );
    }

    public function down( $context )
    {
        $object = \eZContentObject::fetchByRemoteID( self::REMOTE_ID );
        if ( !$object instanceof \eZContentObject )
            return array( 'the folder Press releases was already gone' );
        \expContentWriter::remove( $object, true );
        return array( 'moved the folder Press releases to the trash' );
    }
}

<?php
class expMySiteEventSync
{
    /**
     * @param array $record the other system's record: id, title, description (HTML), cancelled
     * @return array the expContentWriter answer
     */
    public static function apply( array $record, $parentNodeID )
    {
        $remoteID = 'booking-event-' . (int)$record['id'];
        $object = eZContentObject::fetchByRemoteID( $remoteID );
        if ( !empty( $record['cancelled'] ) )
        {
            return $object instanceof eZContentObject
                ? expContentWriter::remove( $object, true )
                : array( 'status' => 'published', 'message' => 'Nothing to remove', 'object' => null, 'version' => 0 );
        }
        $values = array( 'title' => (string)$record['title'], 'intro' => (string)$record['description'] );
        if ( $object instanceof eZContentObject )
            return expContentWriter::update( $object, $values );
        return expContentWriter::create( array( 'parentNodeID' => (int)$parentNodeID, 'classIdentifier' => 'exp_event',
                                                'languageLocale' => 'eng-US', 'remoteID' => $remoteID,
                                                'attributes' => $values ) );
    }
}

curl -s -X PUT -H "Authorization: Bearer $EXP_API_KEY" -H "Content-Type: application/json" \
     -d '{"languageLocale":"eng-US","title":"Opening moved to eleven"}' \
     https://www.example.com/api/ezp/v2/content/node/<node id>
# {"message":"Updated","objectId":<object id>,"nodeId":<node id>,"version":<version>,"languageLocale":"eng-US"}

<?php
$parent = eZContentObjectTreeNode::fetch( $parentNodeID );
$class = eZContentClass::fetchByIdentifier( 'exp_event' );
if ( !$parent || !$class || !expRestContentPermission::createAllowed( $parent, $class, 'eng-US' ) )
    return array( 'error' => 'You may not create an event here.' );

$result = expContentWriter::create( array( 'parentNodeID' => $parentNodeID, 'classIdentifier' => 'exp_event',
                                           'languageLocale' => 'eng-US', 'attributes' => $values ) );